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 à partir duquel le conteneur sera supprimé. L’appelant a obtenu précédemment ce pointeur en appelant ClfsCreateLogFile.
[in] puszContainerPath
Pointeur vers une structure UNICODE_STRING qui fournit le nom du chemin d’accès du conteneur à supprimer. Le nom du chemin a été créé dans un appel précédent à ClfsAddLogContainer ou ClfsAddLogContainerSet. Le chemin d’accès 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
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.
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 |