CloseAndResetLogFile-Funktion (clfsw32.h)

  • Artikel

Setzt die Protokolldatei zurück und schließt dann das Protokoll. Dadurch werden alle Clientneustartbereiche nullisiert und die Basisprotokollsequenznummer (Base Log Sequence Number, LSN) für das Protokoll zurückgesetzt. Sie müssen ein Protokolldatenstromhandle nach dem Aufrufen dieser Funktion nicht schließen.

Syntax

CLFSUSER_API BOOL CloseAndResetLogFile(
  [in] HANDLE hLog
);

Parameter

[in] hLog

Ein Handle für ein dediziertes oder multiplexiertes Protokoll.

Dieses Handle wird durch einen erfolgreichen Aufruf von CreateLogFile zurückgegeben. Sie wird bei erfolgreichem Abschluss des Aufrufs ungültig. Nach der Rückgabe dieser Funktion können keine anderen Vorgänge aufgerufen werden, die dieses Handle oder eine Ableitung dieses Handles verwenden.

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Die folgende Liste identifiziert die möglichen Fehlercodes:

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 clfsw32.h
Bibliothek Clfsw32.lib
DLL Clfsw32.dll

Weitere Informationen

Allgemeine Protokolldateifunktionen

CreateLogFile