Fonction HandleLogFull (clfsmgmtw32.h)

La fonction HandleLogFull est appelée par un client de journal managé lorsqu’une tentative de réservation ou d’ajout à un journal échoue avec un message d’erreur de journal complet. Le gestionnaire de journaux tente de résoudre la condition complète du journal pour le client et avertit le client quand le résultat est connu. À la suite de cet appel, la taille du journal peut s’agrandir.

Syntaxe

CLFSUSER_API BOOL HandleLogFull(
  [in] HANDLE hLog
);

Paramètres

[in] hLog

Handle du journal sur lequel résoudre la condition complète du journal. Le handle doit avoir été inscrit auprès de RegisterManageableLogClient.

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. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. Les valeurs valides sont les suivantes :

Remarques

Si des conteneurs sont créés pour résoudre une condition de journalisation complète, ils sont créés à l’aide du contexte de sécurité de l’application appelante.

HandleLogFull génère toujours un comportement asynchrone ou une erreur ; si elle retourne false et que GetLastError retourne ERROR_IO_PENDING, le résultat est un comportement asynchrone. Si une demande est asynchrone, une notification est envoyée au client lorsque le gestionnaire a résolu la condition complète du journal ou qu’il échoue.

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 clfsmgmtw32.h
Bibliothèque Clfsw32.lib
DLL Clfsw32.dll