ClfsRemoveLogContainerSet, fonction (wdm.h)
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 |