ClfsAdvanceLogBase-Funktion (wdm.h)
Die ClfsAdvanceLogBase-Routine legt den Basis-LSN eines CLFS-Streams fest.
Syntax
CLFSUSER_API NTSTATUS ClfsAdvanceLogBase(
[in, out] PVOID pvMarshalContext,
[in] PCLFS_LSN plsnBase,
[in] ULONG fFlags
);
Parameter
[in, out] pvMarshalContext
Ein Zeiger auf einen undurchsichtigen Kontext, der einen Marshallbereich darstellt, der einem CLFS-Stream zugeordnet ist. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen von ClfsCreateMarshallingArea abgerufen.
[in] plsnBase
Ein Zeiger auf eine CLFS_LSN-Struktur , die den neuen Basis-LSN enthält. Dieser Parameter muss der LSN eines der Datensätze im Stream sein. Außerdem muss dieser Parameter größer oder gleich dem aktuellen Basis-LSN des Datenstroms und kleiner oder gleich dem aktuellen letzten LSN des Datenstroms sein.
[in] fFlags
Dieser Parameter ist für die Systemverwendung reserviert. Aufrufer müssen diesen Parameter auf Null festlegen.
Rückgabewert
ClfsAdvanceLogBase gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der in "Ntstatus.h" definierten Fehlercodes zurückgegeben.
Hinweise
ClfsAdvanceLogBase schreibt keine Datensätze in das CLFS-Protokoll. Die einzigen Aktualisierungen des Protokolls befinden sich in den Metadaten. Wenn Sie den Basis-LSN aktualisieren und gleichzeitig einen Neustartdatensatz in einen Stream schreiben möchten, rufen Sie ClfsWriteRestartArea auf.
Wenn möglich, vermeidet CLFS das Schreiben von Protokolldatensätzen in Warteschlange, die LSNs kleiner als der neue Basis-LSN haben, in stabilen Speicher.
ClfsAdvanceLogBase überprüft nicht, ob der in plsnBase bereitgestellte LSN tatsächlich der LSN eines der Datensätze im Stream ist. Wenn der Aufrufer plsnBase auf einen LSN festlegt, der nicht der LSN eines der Datensätze im Stream ist, wird der Basis-LSN des Streams auf einen bedeutungslosen Wert festgelegt.
Eine Erläuterung der CLFS-Konzepte und -Terminologie finden Sie unter Allgemeines Protokolldateisystem.
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 (einschließen von Wdm.h) |
Bibliothek | Clfs.lib |
DLL | Clfs.sys |
IRQL | <= APC_LEVEL |