ClfsRemoveLogContainerSet, fonction (wdm.h)

Article
02/27/2024

La routine ClfsRemoveLogContainerSet supprime atomiquement un ensemble de conteneurs d’un journal CLFS.

Syntaxe

CLFSUSER_API NTSTATUS ClfsRemoveLogContainerSet(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] USHORT           cContainers,
  [in] PUNICODE_STRING  rgwszContainerPath,
  [in] BOOLEAN          fForce
);

Paramètres

[in] plfoLog

Pointeur vers une structure LOG_FILE_OBJECT qui représente le journal CLFS dont les conteneurs seront supprimés. L’appelant a précédemment obtenu ce pointeur en appelant ClfsCreateLogFile.

[in] cContainers

Nombre de conteneurs dans l’ensemble. Il s’agit du nombre d’éléments dans le tableau rgwszContainerPath .

[in] rgwszContainerPath

Pointeur vers un tableau de structures UNICODE_STRING , chacune d’entre elles fournit le nom de chemin d’accès pour l’un des conteneurs à supprimer. Le nombre d’éléments dans le tableau est donné par cContainers. Un chemin donné 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

ClfsRemoveLogContainerSet 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 de conteneurs (fForce = TRUE) réussit uniquement si les conteneurs à supprimer ne font 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