Freigeben über


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

Weitere Informationen

ClfsWriteRestartArea