Freigeben über


ClfsReadRestartArea-Funktion (wdm.h)

Die ClfsReadRestartArea- Routine liest den Neustartdatensatz, der zuletzt in einen angegebenen CLFS-Stream geschrieben wurde.

Syntax

CLFSUSER_API NTSTATUS ClfsReadRestartArea(
  [in, out] PVOID     pvMarshalContext,
  [out]     PVOID     *ppvRestartBuffer,
  [out]     PULONG    pcbRestartBuffer,
  [out]     PCLFS_LSN plsn,
  [out]     PVOID     *ppvReadContext
);

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.

[out] ppvRestartBuffer

Ein Zeiger auf eine Variable, die einen Zeiger auf den Datenpuffer des Neustartdatensatzes empfängt.

[out] pcbRestartBuffer

Ein Zeiger auf eine ULONG-Typvariable, die die Größe des Datenpuffers in Byte empfängt, auf den pcbRestartBufferverweist. Dies ist die Länge des Datenpuffers des Neustartdatensatzes.

[out] plsn

Ein Zeiger auf eine CLFS_LSN Struktur, die den LSN des gelesenen Neustartdatensatzes empfängt.

[out] ppvReadContext

Ein Zeiger auf eine Variable, die einen Zeiger auf einen undurchsichtigen Lesekontext empfängt. Der Aufrufer kann diesen Kontext an ClfsReadPreviousRestartArea oder ClfsReadNextLogRecordübergeben. Wenn der Aufrufer den Lesekontext verwendet hat, muss er den Kontext freigeben, indem er ClfsTerminateReadLogaufruft.

Rückgabewert

ClfsReadRestartArea gibt STATUS_SUCCESS zurück, wenn sie erfolgreich ist; andernfalls wird eine der fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.

Bemerkungen

Eine Erläuterung der CLFS-Konzepte und -Terminologie finden Sie unter Common Log File System.

Informationen zum Lesen von Datensätzen aus CLFS-Streams finden Sie unter Lesen von Datensätzen aus einem CLFS Stream- und Lesen von Neustartdatensätzen aus einem CLFS-Stream-.

Lesekontexte sind nicht threadsicher. Clients sind für die Serialisierung des Zugriffs auf Lesekontexte verantwortlich.

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

Siehe auch

ClfsCreateMarshallingArea

ClfsReadNextLogRecord

ClfsReadPreviousRestartArea

ClfsTerminateReadLog-