SetEndOfLog-Funktion (clfsw32.h)
Diese Funktion ist veraltet. Verwenden Sie stattdessen TruncateLog .
Syntax
CLFSUSER_API BOOL SetEndOfLog(
[in] HANDLE hLog,
[in] PCLFS_LSN plsnEnd,
[in, out, optional] LPOVERLAPPED lpOverlapped
);
Parameter
[in] hLog
Ein Handle für das Protokoll, das aus CreateLogFile abgerufen wird.
Das Protokollhandle muss auf ein dediziertes Protokoll verweisen.
[in] plsnEnd
Ein Zeiger auf eine CLFS_LSN-Struktur , die das neue Ende eines Protokolls angibt.
Der LSN muss zwischen der Basisprotokollsequenznummer (Base Log Sequence Number, LSN) des Protokolls und dem letzten LSN des Protokolls sein.
[in, out, optional] lpOverlapped
Reserviert. Legen Sie lpOverlapped auf NULL fest.
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. In der folgenden Liste werden die möglichen Fehlercodes identifiziert:
Hinweise
Die SetEndOfLog-Funktion abschneidet das Protokoll ab, indem das Ende des Protokolls auf den angegebenen Wert festgelegt wird. Dieser Vorgang funktioniert nur für dedizierte Protokolle.
SetEndOfLog kann nur zum Abschneiden eines Protokolls verwendet werden.
Anforderungen
| 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 |