ClfsRemoveLogContainer, fonction (wdm.h)

Article
02/29/2024

La routine ClfsRemoveLogContainer supprime un conteneur d’un journal CLFS.

Syntaxe

CLFSUSER_API NTSTATUS ClfsRemoveLogContainer(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] PUNICODE_STRING  puszContainerPath,
  [in] BOOLEAN          fForce
);

Paramètres

[in] plfoLog

Pointeur vers une structure LOG_FILE_OBJECT qui représente un journal CLFS dont le conteneur sera supprimé. L’appelant a précédemment obtenu ce pointeur en appelant ClfsCreateLogFile.

[in] puszContainerPath

Pointeur vers une structure de UNICODE_STRING qui fournit le nom du chemin d’accès pour le conteneur à supprimer. Le nom du chemin a été créé lors d’un appel précédent à ClfsAddLogContainer ou ClfsAddLogContainerSet. Le chemin peut être absolu ou relatif à l’emplacement du fichier journal de base pour le journal CLFS représenté par plfoLog. Les chemins d’accès relatifs au fichier journal de base doivent commencer par CLFS_CONTAINER_RELATIVE_PREFIX, qui est le littéral de chaîne (L"%BLF%\ »). Les répertoires « . » et « . » ne sont pas autorisés dans un chemin relatif.

[in] fForce

Valeur booléenne qui spécifie si la suppression du conteneur est forcée (TRUE) ou différée (FALSE).

Valeur retournée

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

Remarques

La suppression forcée du conteneur (fForce = TRUE) réussit uniquement si le conteneur à supprimer ne fait pas partie du journal actif.

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