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-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 |