ClfsSetEndOfLog-Funktion (wdm.h)
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-Datenstrom darstellt. Dieser Datenstrom muss der einzige Datenstrom eines dedizierten Protokolls sein. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen ClfsCreateLogFileabgerufen.
[in] plsnEnd
Ein Zeiger auf eine CLFS_LSN-Struktur, die den LSN des Datensatzes bereitstellt, der zum letzten Datensatz des Datenstroms wird. Dies muss der genaue LSN eines der Datensätze im Datenstrom sein.
Rückgabewert
ClfsSetEndOfLog- gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist; andernfalls wird eine der fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.
Bemerkungen
Der im plsnEnd Wert bereitgestellte LSN wird nicht überprüft. Es liegt in der Verantwortung des Anrufers, einen gültigen LSN bereitzustellen; d. h. einer, der genau die LSN eines Datensatzes im Datenstrom ist.
Dieser von plfoLog dargestellte Datenstrom muss aus einem dedizierten Protokoll stammen. Diese Routine unterstützt keine Datenströme aus Multiplexed-Protokollen.
Eine Erläuterung der CLFS-Konzepte und -Terminologie finden Sie unter 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 derzeit unterstützt.
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 |