clfsQueryLogFileInformation 函式 (wdm.h)

  • 發行項

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

表示 CLFS 數據流 之LOG_FILE_OBJECT 結構的指標。 呼叫端先前藉由呼叫 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.h 中定義的其中一個錯誤碼。

備註

如需CLFS概念和術語的說明，請參閱 一般記錄檔系統。

規格需求

需求 值
最低支援的用戶端 適用於 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows。
目標平台 桌面
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 Clfs.lib
Dll Clfs.sys
IRQL <= APC_LEVEL

另請參閱

ClfsSetLogFileInformation