Partager via


ClfsRemoveLogContainerSet, fonction (wdm.h)

Le 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 à partir duquel les conteneurs seront supprimés. L’appelant a obtenu précédemment 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, chacun fournissant le nom du chemin d’accès de l’un des conteneurs à supprimer. Le nombre d’éléments du 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 de retour

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 du conteneur (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.

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

ClfsAddLogContainerSet

ClfsCreateLogFile

ClfsRemoveLogContainer

LOG_FILE_OBJECT

UNICODE_STRING