ClfsSetEndOfLog-Funktion (wdm.h)

Artikel
02/27/2024

Die ClfsSetEndOfLog-Routine schneidet einen CLFS-Stream ab.

Syntax

CLFSUSER_API NTSTATUS ClfsSetEndOfLog(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] PCLFS_LSN        plsnEnd
);

Parameter

[in] plfoLog

Ein Zeiger auf eine LOG_FILE_OBJECT-Struktur , die einen CLFS-Stream darstellt. Dieser Stream muss der einzige Stream eines dedizierten Protokolls sein. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen von ClfsCreateLogFile abgerufen.

[in] plsnEnd

Ein Zeiger auf eine CLFS_LSN-Struktur , die die LSN des Datensatzes bereitstellt, der der letzte Datensatz des Datenstroms werden soll. Dies muss die genaue LSN eines der Datensätze im Stream sein.

Rückgabewert

ClfsSetEndOfLog gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der in "Ntstatus.h" definierten Fehlercodes zurückgegeben.

Hinweise

Die im plsnEnd-Wert angegebene LSN wird nicht überprüft. Es liegt in der Verantwortung des Aufrufers, eine gültige LSN bereitzustellen; d. h. eine, die die genaue LSN eines Datensatzes im Stream darstellt.

Dieser durch plfoLog dargestellte Stream muss aus einem dedizierten Protokoll stammen. Diese Routine unterstützt keine Streams aus Multiplexprotokollen.

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

Die Kernelmodusroutine ClfsSetEndOfLog ist für die zukünftige Verwendung reserviert und gibt derzeit immer STATUS_NOT_SUPPORTED zurück. Die Benutzermodusroutine SetEndOfLog wird jedoch derzeit unterstützt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows.
Zielplattform	Desktop
Kopfzeile	wdm.h (wdm.h einschließen)
Bibliothek	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL