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