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
STATUS_SUCCESS
 已建立用來管理記錄的用戶端。
STATUS_UNSUCCESSFUL
 CLFS 管理無法建立用戶端來管理記錄。
STATUS_INSUFFICIENT_RESOURCES
 記憶體不足，無法完成作業。
STATUS_INVALID_PARAMETER
 輸入參數無效。
 

此例程也可能傳回其他 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

另請參閱

CLFS_MGMT_CLIENT_REGISTRATION

LOG_FILE_OBJECT