共用方式為

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

要求

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

另請參閱

ClfsSetLogFileInformation