DeleteLogFile, fonction (clfsw32.h)

Marque un journal pour suppression. Le journal est en fait supprimé lorsque tous les handles, zones de marshaling et contextes de lecture du journal sont fermés. Si le journal est un journal physique, ses conteneurs sous-jacents sont supprimés.

Lorsqu’un journal est marqué pour suppression, les demandes d’ouverture de nouveaux flux de journal client échouent.

Note Une fonction étroitement liée est DeleteLogByHandle, qui supprime un journal lorsque le handle du fichier est donné.

 

Syntaxe

CLFSUSER_API BOOL DeleteLogFile(
  [in]           LPCWSTR pszLogFileName,
  [in, optional] PVOID   pvReserved
);

Paramètres

[in] pszLogFileName

Nom du journal.

Ce nom est spécifié lors de la création du journal à l’aide de CreateLogFile. L’exemple suivant identifie le format à utiliser :

rapport:<nom du>journal[ ::nom du< flux de journal]>

<nom> du journal correspond à un chemin d’accès de fichier valide dans le système de fichiers.

<nom >du flux de journal est le nom unique d’un flux de journal dans le journal.

Pour plus d’informations, consultez Types de journaux.

[in, optional] pvReserved

Ce paramètre est réservé et doit être défini sur NULL.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro (0). Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. La liste suivante identifie les codes d’erreur possibles :

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	clfsw32.h
Bibliothèque	Clfsw32.lib
DLL	Clfsw32.dll

Voir aussi

Fonctions courantes du système de fichiers journaux

CreateLogFile

DeleteLogByHandle

SECURITY_ATTRIBUTES