SetLogArchiveTail-Funktion (clfsw32.h)

Artikel
02/28/2024

Legt die letzte archivierte Protokollsequenznummer (LSN) oder den Letzten Archivende eines archivierbaren Protokolls fest.

Syntax

CLFSUSER_API BOOL SetLogArchiveTail(
  [in]                HANDLE    hLog,
  [in]                PCLFS_LSN plsnArchiveTail,
  [in, out, optional] LPVOID    pReserved
);

Parameter

[in] hLog

Ein Handle für das Protokoll, das aus CreateLogFile abgerufen wird.

Das Protokollhandle kann auf ein dediziertes oder multiplextes Protokoll verweisen.

[in] plsnArchiveTail

Ein Zeiger auf eine CLFS_LSN-Struktur , die einen gültigen physischen LSN im Protokoll angibt.

Hinweis Bei Handles für ein physisches Protokoll oder einen Protokolldatenstrom ist plsnArchiveTail ein physischer LSN, da er auf eine Datensatzadresse im physischen Protokoll verweist.

[in, out, optional] pReserved

Dieser Parameter ist reserviert und sollte auf NULL festgelegt werden.

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

Wenn aus PrepareLogArchive abgerufene Archivkontexte vorhanden sind, die nicht mit TerminateLogArchive beendet werden, wird die Änderung erst wirksam, wenn alle Archive abgeschlossen sind. Obwohl es hervorragende Archivkontexte gibt, wird nur der größte Archivschwanz angewendet.

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

CLFS_LSN

Allgemeine Protokolldateisystemfunktionen

OVERLAPPED

RemoveLogContainer

RemoveLogContainerSet

Freigeben über