ClfsSetLogFileInformation 函式（wdm.h）

發行項
02/07/2025

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 概念和術語的說明，請參閱 Common Log File System。

要求

要求	價值
最低支援的用戶端	適用於 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows。
目標平臺	桌面
標頭	wdm.h （包括 Wdm.h）
連結庫	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL