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 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 |
|---|---|
|
Ein Client wurde erstellt, um das Protokoll zu verwalten. |
|
Die CLFS-Verwaltung konnte keinen Client zum Verwalten des Protokolls erstellen. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen. |
|
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 |