HandleLogFull-Funktion (clfsmgmtw32.h)

Die HandleLogFull-Funktion wird von einem verwalteten Protokollclient aufgerufen, wenn der Versuch, ein Protokoll zu reservieren oder an ein Protokoll anzufügen, mit einer vollständigen Protokollfehlermeldung fehlschlägt. Der Protokoll-Manager versucht, die vollständige Protokollbedingung für den Client aufzulösen, und benachrichtigt den Client, wenn das Ergebnis bekannt ist. Durch diesen Aufruf wird das Protokoll möglicherweise größer.

Syntax

CLFSUSER_API BOOL HandleLogFull(
  [in] HANDLE hLog
);

Parameter

[in] hLog

Ein Handle für das Protokoll, in dem die vollständige Protokollbedingung aufgelöst werden soll. Das Handle muss bei RegisterManageableLogClient registriert worden sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Gültige Werte sind:

Hinweise

Wenn Container erstellt werden, um eine Bedingung für das vollständige Protokoll aufzulösen, werden sie mithilfe des Sicherheitskontexts der aufrufenden Anwendung erstellt.

HandleLogFull führt immer zu asynchronen Verhaltensweisen oder einem Fehler. wenn false zurückgegeben wird und GetLastErrorERROR_IO_PENDING zurückgibt, ist das Ergebnis asynchrones Verhalten. Wenn eine Anforderung asynchron ist, wird eine Benachrichtigung an den Client gesendet, wenn der Handler entweder die vollständige Protokollbedingung aufgelöst hat oder ein Fehler auftritt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	clfsmgmtw32.h
Bibliothek	Clfsw32.lib
DLL	Clfsw32.dll