Lire en anglais

Partager via


ClfsCloseAndResetLogFile, fonction (wdm.h)

La routine ClfsCloseAndResetLogFile libère toutes les références à un objet de fichier journal spécifié et marque son flux associé pour la réinitialisation.

Syntaxe

CLFSUSER_API NTSTATUS ClfsCloseAndResetLogFile(
  [in] PLOG_FILE_OBJECT plfoLog
);

Paramètres

[in] plfoLog

Pointeur vers une structure LOG_FILE_OBJECT pour laquelle les références seront publiées. L’appelant a obtenu précédemment ce pointeur en appelant ClfsCreateLogFile.

Valeur de retour

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

Remarques

ClfsCloseAndResetLogFile libère toutes les références, acquises par CLFS, dans l’objet de fichier journal spécifié. En règle générale, le client n’a pas acquis de références supplémentaires à l’objet de fichier journal. Toutefois, si le client a obtenu des références supplémentaires, il incombe au client de les libérer.

ClfsCloseAndResetLogFile entraîne la suppression du nombre de références de l’objet de fichier journal spécifié à zéro, auquel cas l’objet de fichier journal est fermé (autrement dit, sa mémoire est libérée). Le flux représenté par l’objet fichier journal peut ne pas être réinitialisé, toutefois, car il peut y avoir d’autres objets de fichier journal qui représentent le même flux. Le flux est réinitialisé une fois tous les objets de fichier journal qui représentent le flux fermés (par exemple, en appelant ClfsCloseLogFileObject).

Un flux de réinitialisation est semblable à un flux nouvellement créé qui n’a jamais eu d’enregistrements écrits dessus.

À l’issue de cette routine, plfoLog n’est pas valide.

Vous pouvez appeler ClfsCloseAndResetLogFile au maximum 124 fois pour un flux donné.

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

Voir aussi

ClfsCloseLogFileObject

ClfsDeleteLogByPointer

ClfsDeleteLogFile