ClfsDeleteLogFile, fonction (wdm.h)
La routine ClfsDeleteLogFile marque un flux CLFS pour suppression.
Syntaxe
CLFSUSER_API NTSTATUS ClfsDeleteLogFile(
[in] PUNICODE_STRING puszLogFileName,
PVOID pvReserved,
[in] ULONG fLogOptionFlag,
[in, optional] PVOID pvContext,
[in] ULONG cbContext
);
Paramètres
[in] puszLogFileName
Pointeur vers une structure UNICODE_STRING qui fournit le nom du flux CLFS à supprimer.
Si le flux à supprimer est le seul flux d’un journal dédié, le nom a le journal de formulaire :nom du journal physique, où nom du journal physique est le nom du chemin d’accès du journal physique sur le système de fichiers sous-jacent.
Si le flux à supprimer est l’un des flux d’un journal multiplexé, le nom a le journal de formulaire :nom du journal physique::nom de flux, où nom de journal physique est le nom du chemin d’accès du journal physique sur le système de fichiers sous-jacent et nom de flux est le nom unique du flux à supprimer.
pvReserved
Réservé.
[in] fLogOptionFlag
Valeur qui indique la relation entre CLFS et le composant qui supprime le journal. Pour obtenir la liste des valeurs possibles, consultez la description du paramètre fLogOptionFlag de la routine ClfsCreateLogFile.
[in, optional] pvContext
Pointeur vers un contexte. La façon dont le contexte est interprété dépend de la valeur passée dans fLogOptionFlag.
[in] cbContext
Taille, en octets, du contexte pointé par pvContext. Si pvContext n’est pas NULL, ce paramètre doit être supérieur à zéro.
Valeur de retour
ClfsDeleteLogFile retourne STATUS_SUCCESS si elle réussit ; sinon, elle retourne l’un des codes d’erreur définis dans Ntstatus.h.
Remarques
Common Log File System (CLFS) utilise la structure LOG_FILE_OBJECT pour représenter les journaux. La fonction ClfsCreateLogFile retourne un pointeur vers LOG_FILE_OBJECT, que les clients passent ensuite à d’autres fonctions CLFS.
Les clients CLFS n’accèdent pas directement aux membres d’une structure LOG_FILE_OBJECT. Pour plus d’informations sur les membres, consultez FILE_OBJECT.
ClfsDeleteLogFile marque un flux de suppression, mais ne ferme aucun objet de fichier journal actuellement ouvert. Pour fermer un objet de fichier journal, appelez ClfsCloseLogFileObject. Un flux marqué pour suppression est supprimé une fois tous les objets de fichier journal associés au flux fermés.
Un flux CLFS marqué pour suppression refuse les demandes suivantes pour ouvrir le flux.
Le nom d’un journal CLFS physique n’inclut pas l’extension .blf.
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 |