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 值之一：

返回代码 说明
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）
Library Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

另请参阅

CLFS_MGMT_CLIENT_REGISTRATION

LOG_FILE_OBJECT