DeleteLogByHandle, fonction (clfsw32.h)

  • Article

Marque le journal spécifié 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 Cette fonction diffère de DeleteLogFile, car elle prend un handle ouvert valide pour l’objet journal au lieu du nom du journal.
 

Syntaxe

CLFSUSER_API BOOL DeleteLogByHandle(
  [in] HANDLE hLog
);

Paramètres

[in] hLog

Handle d’un journal ouvert obtenu par un appel réussi à CreateLogFile. Le journal doit avoir été créé avec l’accès DELETE ou vous ne pouvez pas le supprimer.

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

DeleteLogFile