CloseAndResetLogFile-Funktion (clfsw32.h)
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 |