ClfsQueryLogFileInformation-Funktion (wdm.h)

Artikel
02/29/2024

Die ClfsQueryLogFileInformation-Routine gibt Metadaten und Zustandsinformationen für einen angegebenen CLFS-Stream oder sein zugrunde liegendes physisches Protokoll oder beides zurück.

Syntax

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-Stream darstellt. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen von ClfsCreateLogFile abgerufen.

[in] eInformationClass

Ein Wert aus der CLFS_LOG_INFORMATION_CLASS-Enumeration , der 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 von eInformationClass ab. Die folgende Tabelle zeigt die Beziehung zwischen der Informationsklasse und dem Datentyp des Puffers.

Wert von eInformationClass	Typ des Puffers, auf den pinfoBuffer verweist
ClfsLogBasicInformation	CLFS_INFORMATION
ClfsLogBasicInformationPhysical	CLFS_INFORMATION
ClfsLogNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogPhysicalNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogStreamIdentifierInformation	CLFS_STREAM_ID_INFORMATION

pcbInfoBuffer

Länge des eingehenden Informationspuffers in Bytes.

Rückgabewert

ClfsQueryLogFileInformation gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist. Andernfalls wird einer der in "Ntstatus.h" definierten Fehlercodes zurückgegeben.

Hinweise

Eine Erläuterung der CLFS-Konzepte und -Terminologie finden Sie unter Allgemeines Protokolldateisystem.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows.
Zielplattform	Desktop
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

Weitere Informationen

ClfsSetLogFileInformation

Freigeben über