ClfsQueryLogFileInformation, fonction (wdm.h)

Article
02/07/2025

La routine ClfsQueryLogFileInformation retourne des métadonnées et des informations d’état pour un flux CLFS spécifié ou son journal physique sous-jacent ou les deux.

Syntaxe

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

Paramètres

[in] plfoLog

Pointeur vers une structure LOG_FILE_OBJECT qui représente un flux CLFS. L’appelant a obtenu précédemment ce pointeur en appelant ClfsCreateLogFile.

[in] eInformationClass

Valeur de l’énumération CLFS_LOG_INFORMATION_CLASS qui spécifie le type d’informations demandées.

pinfoInputBuffer

Mémoire tampon d’entrée facultative requise pour certaines classes d’informations.

cbinfoInputBuffer

Longueur en octets de pinfoInputBuffer.

[out] pinfoBuffer

Pointeur vers une mémoire tampon qui reçoit les informations du journal. La structure de cette mémoire tampon dépend de la valeur de eInformationClass. Le tableau suivant montre la relation entre la classe d’informations et le type de données de la mémoire tampon.

Valeur de eInformationClass	Type de mémoire tampon pointée par pinfoBuffer
ClfsLogBasicInformation	CLFS_INFORMATION
ClfsLogBasicInformationPhysical	CLFS_INFORMATION
ClfsLogNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogPhysicalNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogStreamIdentifierInformation	CLFS_STREAM_ID_INFORMATION

pcbInfoBuffer

Longueur en octets de la mémoire tampon d’informations entrantes.

Valeur de retour

ClfsQueryLogFileInformation retourne STATUS_SUCCESS si elle réussit ; sinon, elle retourne l’un des codes d’erreur définis dans Ntstatus.h.

Remarques

Pour obtenir une explication des concepts et de la terminologie CLFS, consultez Common Log File System.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows Server 2003 R2, Windows Vista et versions ultérieures de Windows.
plateforme cible	Bureau
d’en-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
bibliothèque	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

Voir aussi

ClfsSetLogFileInformation

Partager via