ClfsMgmtRegisterManagedClient-Funktion (wdm.h)

  • Artikel

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 instance der CLFS_MGMT_CLIENT_REGISTRATION-Struktur, die die Funktionen enthält, die zum Verwalten des Protokolls verwendet werden.

ClientCookie

Das Cookie, das wir an den 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
 Ein Client wurde erstellt, um das Protokoll zu verwalten.
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 gibt möglicherweise auch andere NTSTATUS-Werte zurück.

Hinweise

Der Clientparameter , der von der 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 ihre Rückrufroutine aufgerufen wird, sobald sie die ClfsMgmtRegisterManagedClient-Routine aufruft .

Mehrere Clients können sich mit einem Protokolldatenstrom registrieren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows.
Zielplattform Desktop
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Weitere Informationen

CLFS_MGMT_CLIENT_REGISTRATION

LOG_FILE_OBJECT