ClfsQueryLogFileInformation-Funktion (wdm.h)

Artikel
07.02.2025

Die ClfsQueryLogFileInformation Routine gibt Metadaten und Statusinformationen für einen angegebenen CLFS-Datenstrom oder dessen zugrunde liegendes physisches Protokoll oder beides zurück.

Syntax

C++

CLFSUSER_API NTSTATUS ClfsQueryLogFileInformation(
  [in]  PLOG_FILE_OBJECT           plfoLog,
  [in]  CLFS_LOG_INFORMATION_CLASS eInformationClass,
        PVOID                      pinfoInputBuffer,
        ULONG                      cbinfoInputBuffer,
  [out] PVOID                      pinfoBuffer,
        PULONG                     pcbInfoBuffer
);

Parameter

[in] plfoLog

Ein Zeiger auf eine LOG_FILE_OBJECT Struktur, die einen CLFS-Datenstrom darstellt. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen ClfsCreateLogFileabgerufen.

[in] eInformationClass

Ein Wert aus der CLFS_LOG_INFORMATION_CLASS-Aufzählung, die den Typ der angeforderten Informationen angibt.

pinfoInputBuffer

Optionaler Eingabepuffer, der für einige Informationsklassen erforderlich ist.

cbinfoInputBuffer

Länge in Bytes von pinfoInputBuffer.

[out] pinfoBuffer

Ein Zeiger auf einen Puffer, der die Protokollinformationen empfängt. Die Struktur dieses Puffers hängt vom Wert eInformationClassab. Die folgende Tabelle zeigt die Beziehung zwischen der Informationsklasse und dem Datentyp des Puffers.

Wert von eInformationClass-	Typ des Puffers, der von pinfoBuffer-
ClfsLogBasicInformation	CLFS_INFORMATION
ClfsLogBasicInformationPhysical	CLFS_INFORMATION
ClfsLogNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogPhysicalNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogStreamIdentifierInformation	CLFS_STREAM_ID_INFORMATION

pcbInfoBuffer

Länge in Byte des Eingehenden Informationspuffers.

Rückgabewert

ClfsQueryLogFileInformation gibt STATUS_SUCCESS zurück, wenn sie erfolgreich ist; andernfalls wird eine der fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.

Bemerkungen

Eine Erläuterung der CLFS-Konzepte und -Terminologie finden Sie unter Common Log File System.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows.
Zielplattform-	Desktop
Header-	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library	Clfs.lib
DLL-	Clfs.sys
IRQL-	<= APC_LEVEL

Siehe auch

ClfsSetLogFileInformation

Freigeben über