ClfsMgmtRegisterManagedClient 函式 (wdm.h)
ClfsMgmtRegisterManagedClient 例程會建立將管理 CLFS 記錄的用戶端。
語法
CLFSUSER_API NTSTATUS ClfsMgmtRegisterManagedClient(
[in] PLOG_FILE_OBJECT LogFile,
[in] PCLFS_MGMT_CLIENT_REGISTRATION RegistrationData,
PCLFS_MGMT_CLIENT ClientCookie
);
參數
[in] LogFile
LOG_FILE_OBJECT 結構的指標,代表 ClfsMgmtRegisterManagedClient 所建立之用戶端所建立的 CLFS 記錄數據流。
[in] RegistrationData
CLFS_MGMT_CLIENT_REGISTRATION 結構的實例,其中包含將用來管理記錄的函式。
ClientCookie
我們回傳給呼叫端的 Cookie,以供日後使用 API。
傳回值
ClfsMgmtRegisterManagedClient 例程會傳回下列其中一個 NTSTATUS 值:
傳回碼 | Description |
---|---|
|
已建立用來管理記錄的用戶端。 |
|
CLFS 管理無法建立用戶端來管理記錄。 |
|
記憶體不足,無法完成作業。 |
|
輸入參數無效。 |
此例程也可能傳回其他 NTSTATUS值。
備註
ClfsMgmtRegisterManagedClient 例程所提供的 Client 參數是其他 CLFS 管理功能的必要參數。 您應該儲存此值以供稍後使用。
用戶端應用程式必須在呼叫 ClfsMgmtRegisterManagedClient 例程時立即呼叫其回呼例程。
多個用戶端可以向記錄數據流註冊。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows。 |
目標平台 | 桌面 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
程式庫 | Clfs.lib |
Dll | Clfs.sys |
IRQL | <= APC_LEVEL |