clfsSetLogFileInformation 函数 (wdm.h)

项目
02/29/2024

ClfsSetLogFileInformation 例程设置指定流及其基础物理日志的元数据和状态信息。

语法

CLFSUSER_API NTSTATUS ClfsSetLogFileInformation(
  [in] PLOG_FILE_OBJECT           plfoLog,
  [in] CLFS_LOG_INFORMATION_CLASS eInformationClass,
  [in] PVOID                      pinfoBuffer,
  [in] ULONG                      cbBuffer
);

参数

[in] plfoLog

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

[in] eInformationClass

一个CLFS_LOG_INFORMATION_CLASS值，该值指定要设置的信息的类。

[in] 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

[in] cbBuffer

pinfoBuffer 指向的缓冲区的大小（以字节为单位）。

返回值

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

注解

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

要求

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