ClfsCloseLogFileObject, fonction (wdm.h)

La routine ClfsCloseLogFileObject libère toutes les références à un objet de fichier journal.

Syntaxe

CLFSUSER_API NTSTATUS ClfsCloseLogFileObject(
  [in] PLOG_FILE_OBJECT plfoLog
);

Paramètres

[in] plfoLog

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

Valeur retournée

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

Remarques

ClfsCloseLogFileObject libère toutes les références, acquises par CLFS, à 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 lui incombe de les libérer.

ClfsCloseLogFileObject entraîne la chute du nombre de références de l’objet de fichier journal spécifié à zéro, date à laquelle l’objet de fichier journal est fermé (c’est-à-dire que sa mémoire est libérée). Toutefois, le flux représenté par l’objet fichier journal peut rester ouvert, car d’autres objets de fichier journal peuvent représenter le même flux. Le flux est fermé après la fermeture de tous les objets de fichier journal qui représentent le flux.

Au retour de cette routine, plfoLog n’est pas valide.

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

Voir aussi

ClfsCloseAndResetLogFile

ClfsCreateLogFile