ClfsSetLogFileInformation, fonction (wdm.h)

Article
02/07/2025

Le ClfsSetLogFileInformation routine définit des métadonnées et des 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 obtenu précédemment 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 du 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 par 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 par pinfoBuffer.

Valeur de retour

ClfsSetLogFileInformation 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)
bibliothèque	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL