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 Marshallingbereich darstellt, der einem CLFS-Stream zugeordnet ist. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen ClfsCreateMarshallingAreaabgerufen.
[in] plsnBase
Ein Zeiger auf eine CLFS_LSN Struktur, die die neue Basis-LSN enthält. Dieser Parameter muss der LSN eines der Datensätze im Datenstrom 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 STATUS_SUCCESS zurück, wenn sie erfolgreich ist; andernfalls wird eine der fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.
Bemerkungen
ClfsAdvanceLogBase- schreibt keine Datensätze in das CLFS-Protokoll; die einzigen Aktualisierungen des Protokolls sind in den Metadaten enthalten. Wenn Sie den Basis-LSN aktualisieren und gleichzeitig einen Neustartdatensatz in einen Datenstrom schreiben möchten, rufen Sie ClfsWriteRestartAreaauf.
Nach Möglichkeit vermeidet CLFS das Schreiben von Protokolldatensätzen in der Warteschlange, die LSNs kleiner als der neue Basis-LSN sind, um stabilen Speicher zu speichern.
ClfsAdvanceLogBase überprüft nicht, ob der in plsnBase bereitgestellte LSN tatsächlich der LSN eines der Datensätze im Datenstrom ist. Wenn der Aufrufer plsnBase auf einen LSN festlegt, der nicht der LSN eines der Datensätze im Datenstrom ist, wird der Basis-LSN des Datenstroms auf einen bedeutungslosen Wert festgelegt.
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 |