clfsSetLogFileInformation 函式 (wdm.h)

發行項
02/27/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)
程式庫	Clfs.lib
Dll	Clfs.sys
IRQL	<= APC_LEVEL