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
我们返回给调用方供将来使用 API 的 Cookie。
返回值
ClfsMgmtRegisterManagedClient 例程返回以下 NTSTATUS 值之一:
返回代码 | 说明 |
---|---|
|
已创建一个客户端来管理日志。 |
|
CLFS 管理无法创建客户端来管理日志。 |
|
内存不足,无法完成操作。 |
|
输入参数无效。 |
此例程还可能返回其他 NTSTATUS 值。
注解
ClfsMgmtRegisterManagedClient 例程提供的 Client 参数是其他 CLFS 管理功能的必需参数。 应存储此值以供以后使用。
客户端应用程序必须在调用 ClfsMgmtRegisterManagedClient 例程后立即准备好调用其回调例程。
多个客户端可以使用日志流注册。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Windows Server 2003 R2、Windows Vista 和更高版本的 Windows 中可用。 |
目标平台 | 桌面 |
标头 | wdm.h(包括 Wdm.h、Ntddk.h、Ntifs.h) |
Library | Clfs.lib |
DLL | Clfs.sys |
IRQL | <= APC_LEVEL |