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 von ClfsCreateMarshallingArea abgerufen.

[out] ppvRestartBuffer

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

[out] pcbRestartBuffer

Ein Zeiger auf eine Variable vom Typ ULONG, die die Größe des Datenpuffers in Bytes empfängt, auf den von pcbRestartBuffer verwiesen wird. Dies ist die Länge des Datenpuffers des Neustartdatensatzes.

[out] plsn

Ein Zeiger auf eine CLFS_LSN-Struktur, die die 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 die Verwendung des Lesekontexts abgeschlossen hat, muss er den Kontext durch Aufrufen von ClfsTerminateReadLog freigeben.

Rückgabewert

ClfsReadRestartArea gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der in "Ntstatus.h" definierten Fehlercodes zurückgegeben.

Hinweise

Eine Erläuterung der CLFS-Konzepte und -Terminologie finden Sie unter Common Log File System( 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
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

Weitere Informationen

ClfsCreateMarshallingArea

ClfsReadNextLogRecord

ClfsReadPreviousRestartArea

ClfsTerminateReadLog