ClfsQueryLogFileInformation, fonction (wdm.h)

  • Article

La routine ClfsQueryLogFileInformation retourne des métadonnées et des informations d’état pour un flux CLFS spécifié, 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 précédemment obtenu 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 de journal. La structure de cette mémoire tampon dépend de la valeur d’eInformationClass. Le tableau suivant montre la relation entre la classe d’informations et le type de données de la mémoire tampon.

Valeur d’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 retournée

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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Server 2003 R2, Windows Vista et versions ultérieures de Windows.
Plateforme cible Desktop (Expérience utilisateur)
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