ClfsSetArchiveTail-Funktion (wdm.h)

Artikel
07.02.2025

Die ClfsSetArchiveTail- Routine legt den Archivschwanz eines CLFS-Protokolls auf einen angegebenen LSN fest.

Syntax

C++

CLFSUSER_API NTSTATUS ClfsSetArchiveTail(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] PCLFS_LSN        plsnArchiveTail
);

Parameter

[in] plfoLog

Ein Zeiger auf eine LOG_FILE_OBJECT Struktur, die ein CLFS-Protokoll darstellt. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen ClfsCreateLogFileabgerufen.

[in] plsnArchiveTail

Ein Zeiger auf eine CLFS_LSN-Struktur, die den LSN angibt, der zum neuen Archivschwanz werden soll. Dies muss der genaue LSN eines Datensatzes im Protokoll sein.

Rückgabewert

ClfsSetArchiveTail- gibt STATUS_SUCCESS zurück, wenn sie erfolgreich ist; andernfalls wird eine der fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.

Bemerkungen

Der wert plsnArchiveTail gibt an, wo die Archivierung im Protokoll beginnt. Die nächste Archivierung beginnt bei oder vor diesem LSN.

Eine Erläuterung der CLFS-Konzepte und -Terminologie finden Sie unter Common Log File System.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows.
Zielplattform-	Desktop
Header-	wdm.h (include Wdm.h)
Library	Clfs.lib
DLL-	Clfs.sys
IRQL-	<= APC_LEVEL