ClfsMgmtRegisterManagedClient-Funktion (wdm.h)

Die ClfsMgmtRegisterManagedClient Routine erstellt einen Client, der ein CLFS-Protokoll verwaltet.

Syntax

CLFSUSER_API NTSTATUS ClfsMgmtRegisterManagedClient(
  [in] PLOG_FILE_OBJECT               LogFile,
  [in] PCLFS_MGMT_CLIENT_REGISTRATION RegistrationData,
       PCLFS_MGMT_CLIENT              ClientCookie
);

Parameter

[in] LogFile

Ein Zeiger auf eine LOG_FILE_OBJECT Struktur, die den CLFS-Protokolldatenstrom darstellt, den der von ClfsMgmtRegisterManagedClient erstellte Client verwaltet.

[in] RegistrationData

Eine Instanz der CLFS_MGMT_CLIENT_REGISTRATION-Struktur, die die Funktionen enthält, die zum Verwalten des Protokolls verwendet werden.

ClientCookie

Das Cookie, das wir dem Aufrufer zur zukünftigen Verwendung der API zurückgeben.

Rückgabewert

Die ClfsMgmtRegisterManagedClient Routine gibt einen der folgenden NTSTATUS-Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS
Zum Verwalten des Protokolls wurde ein Client erstellt.
STATUS_UNSUCCESSFUL
Die CLFS-Verwaltung konnte keinen Client zum Verwalten des Protokolls erstellen.
STATUS_INSUFFICIENT_RESOURCES
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen.
STATUS_INVALID_PARAMETER
Ein Eingabeparameter ist ungültig.
 

Diese Routine kann auch andere NTSTATUS-Wertezurückgeben.

Bemerkungen

Der Client Parameter, der vom ClfsMgmtRegisterManagedClient Routine bereitgestellt wird, ist ein erforderlicher Parameter für andere CLFS-Verwaltungsfunktionen. Sie sollten diesen Wert zur späteren Verwendung speichern.

Eine Clientanwendung muss bereit sein, damit die Rückrufroutine aufgerufen wird, sobald sie die ClfsMgmtRegisterManagedClient Routine aufruft.

Mehrere Clients können sich bei einem Protokolldatenstrom registrieren.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows.
Zielplattform- Desktop
Header- wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library Clfs.lib
DLL- Clfs.sys
IRQL- <= APC_LEVEL

Siehe auch

CLFS_MGMT_CLIENT_REGISTRATION

LOG_FILE_OBJECT