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 dans le 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.
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 :
journal :<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 de 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 de retour
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’erreur étendues, appelez GetLastError. La liste suivante identifie les codes d’erreur possibles :
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 R2 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | clfsw32.h |
| bibliothèque | Clfsw32.lib |
| DLL | Clfsw32.dll |