ClfsQueryLogFileInformation-Funktion (wdm.h)

  • Artikel

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