通过

ClfsGetContainerName 函数 （wdm.h）

  • 项目

ClfsGetContainerName 例程返回指定容器的路径名称。

语法

CLFSUSER_API NTSTATUS ClfsGetContainerName(
  [in]            PLOG_FILE_OBJECT  plfoLog,
  [in]            CLFS_CONTAINER_ID cidLogicalContainer,
  [out]           PUNICODE_STRING   puszContainerName,
  [out, optional] PULONG            pcActualLenContainerName
);

参数

[in] plfoLog

指向表示 CLFS 日志的 LOG_FILE_OBJECT 结构的指针。 调用方之前通过调用 ClfsCreateLogFile获取此指针。

[in] cidLogicalContainer

CLFS 日志中容器的逻辑标识符。

[out] puszContainerName

指向 UNICODE_STRING 结构的指针。 puszContainerName 的 Buffer 成员必须指向接收容器路径名称的调用方分配的缓冲区。 MaximumLength 成员必须提供缓冲区的大小。

[out, optional] pcActualLenContainerName

指向 ULONG 类型的变量的指针，该变量接收容器的路径名称的实际长度（以 Unicode 字符为单位）。 此参数可以 NULL。

返回值

ClfsGetContainerName 返回 Ntstatus.h 中定义的状态代码之一。 下表提供了各种返回值的含义。

返回代码 描述
STATUS_SUCCESS
 puszContainerName 的 Buffer 成员接收容器的完整路径名称。 如果 pcActualLenContainerName 未 NULL，则会接收完整路径名称的 Unicode 字符的实际长度。
STATUS_BUFFER_OVERFLOW
 完整路径名称的实际长度大于 puszContainerName->MaximumLength。 puszContainerName 的 Buffer 成员接收截断到由 puszContainerName->MaximumLength指定的字符数的容器的完整路径名称。 如果 pcActualLenContainerName 未 NULL，则会接收完整路径名称的 Unicode 字符的实际长度。
其他
 返回时，未定义 puszContainerName->Buffer 和 pcActualLenContainerName 的内容。

言论

有关 CLFS 概念和术语的说明，请参阅 通用日志文件系统。

要求

要求 价值
最低支持的客户端 在 Windows Server 2003 R2、Windows Vista 和更高版本的 Windows 中可用。
目标平台 桌面
标头 wdm.h （包括 Wdm.h）
库 Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

另请参阅

ClfsAddLogContainer

ClfsRemoveLogContainer