ClfsReadPreviousRestartArea-Funktion (wdm.h)

Die ClfsReadPreviousRestartArea-Routine liest den vorherigen Neustartdatensatz relativ zum aktuellen Datensatz in einem Lesekontext.

Syntax

CLFSUSER_API NTSTATUS ClfsReadPreviousRestartArea(
  [in]  PVOID     pvReadContext,
  [out] PVOID     *ppvRestartBuffer,
  [out] PULONG    pcbRestartBuffer,
  [out] PCLFS_LSN plsnRestart
);

Parameter

[in] pvReadContext

Ein Zeiger auf einen Lesekontext, der durch einen vorherigen Aufruf von ClfsReadRestartArea abgerufen wurde.

[out] ppvRestartBuffer

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

[out] pcbRestartBuffer

Ein Zeiger auf eine ULONG-typisierte Variable, die die Größe des Puffers in Bytes empfängt, auf den *ppvRestartBuffer verweist. Dies ist die Länge des Datenpuffers des gelesenen Neustartdatensatzes.

[out] plsnRestart

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

Rückgabewert

ClfsReadPreviousRestartArea gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der in "Ntstatus.h" definierten Fehlercodes zurückgegeben. Wenn keine vorherigen Neustartbereiche vorhanden sind, wird der Rückgabewert STATUS_LOG_START_OF_LOG.

Hinweise

Eine Erläuterung der CLFS-Konzepte und -Terminologie finden Sie unter Allgemeines Protokolldateisystem.

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 einer CLFS-Stream.

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

Clients fügen Neustartdatensätze an ein CLFS-Protokoll an, indem sie ClfsWriteRestartArea aufrufen.

Mit der ReadPreviousLogRestartArea-Routine können Clients eine Form von Fuzzy-Prüfpunkten implementieren. Beispielsweise kann der Prüfpunktzustand aus den Protokolldatensätzen bestehen, die durch zwei oder mehr Neustartdatensätze getrennt sind.

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

CLFS_LSN

ClfsReadRestartArea

ClfsWriteRestartArea