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 |