Fonction ClfsSetLogFileInformation (wdm.h)

Article
02/29/2024

La routine ClfsSetLogFileInformation définit les métadonnées et les informations d’état pour un flux spécifié et son journal physique sous-jacent.

Syntaxe

CLFSUSER_API NTSTATUS ClfsSetLogFileInformation(
  [in] PLOG_FILE_OBJECT           plfoLog,
  [in] CLFS_LOG_INFORMATION_CLASS eInformationClass,
  [in] PVOID                      pinfoBuffer,
  [in] ULONG                      cbBuffer
);

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 CLFS_LOG_INFORMATION_CLASS qui spécifie la classe d’informations en cours de définition.

[in] pinfoBuffer

Pointeur vers une mémoire tampon qui fournit les informations de journal. La structure de cette mémoire tampon varie en fonction de la classe d’informations spécifiée par eInformationClass. Le tableau suivant montre la relation entre la classe d’informations et le type de mémoire tampon.

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

[in] cbBuffer

Taille, en octets, de la mémoire tampon pointée vers pinfoBuffer.

Valeur retournée

ClfsSetLogFileInformation retourne STATUS_SUCCESS si elle réussit ; sinon, il 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 (inclure Wdm.h)
Bibliothèque	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL