ClfsQueryLogFileInformation 函数 (wdm)

ClfsQueryLogFileInformation例程返回指定 CLFS 流或其基础物理日志的元数据和状态信息。

语法

CLFSUSER_API NTSTATUS ClfsQueryLogFileInformation(
  [in]  PLOG_FILE_OBJECT           plfoLog,
  [in]  CLFS_LOG_INFORMATION_CLASS eInformationClass,
        PVOID                      pinfoInputBuffer,
        ULONG                      cbinfoInputBuffer,
  [out] PVOID                      pinfoBuffer,
        PULONG                     pcbInfoBuffer
);

参数

[in] plfoLog

指向 LOG_FILE_OBJECT 结构的指针,该结构表示 CLFS 流。 调用方先前通过调用 ClfsCreateLogFile获取了此指针。

[in] eInformationClass

CLFS_LOG_INFORMATION_CLASS枚举中的一个值,该值指定所请求的信息的类型。

pinfoInputBuffer

某些信息类需要的可选输入缓冲区。

cbinfoInputBuffer

PinfoInputBuffer 的长度(以字节为单位)。

[out] pinfoBuffer

指向接收日志信息的缓冲区的指针。 此缓冲区的结构取决于 eInformationClass的值。 下表显示了信息类和缓冲区的数据类型之间的关系。

EInformationClass的值 PinfoBuffer所指向的缓冲区的类型
ClfsLogBasicInformation

CLFS_INFORMATION

ClfsLogBasicInformationPhysical

CLFS_INFORMATION

ClfsLogNameInformation

CLFS_LOG_NAME_INFORMATION

ClfsLogPhysicalNameInformation

CLFS_LOG_NAME_INFORMATION

ClfsLogStreamIdentifierInformation

CLFS_STREAM_ID_INFORMATION

pcbInfoBuffer

传入信息缓冲区的长度(以字节为单位)。

返回值

如果成功, ClfsQueryLogFileInformation将返回 STATUS_SUCCESS;否则,它将返回 Ntstatus 中定义的错误代码之一。

注解

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

要求

   
最低受支持的客户端 Windows Windows Server 2003 R2、Windows Vista 和更高版本中可用。
目标平台 桌面型
标头 wdm (包括 Wdm、Ntddk、Ntifs)
Library Clfs
.DLL Clfs.sys
IRQL <= APC_LEVEL

请参阅

ClfsSetLogFileInformation