ClfsReadPreviousRestartArea-Funktion (wdm.h)
Die ClfsReadPreviousRestartArea Routine liest den vorherigen Neustartdatensatz relativ zum aktuellen Datensatz in einem Lesekontext vor.
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 von einem vorherigen Aufruf von ClfsReadRestartAreaabgerufen 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-Typvariable, die die Größe des Puffers in Bytes empfängt, auf den *ppvRestartBufferverweist. Dies ist die Länge des Datenpuffers des neu gestarteten Datensatzes, der gelesen wird.
[out] plsnRestart
Ein Zeiger auf eine CLFS_LSN-Struktur, die den vorherigen LSN des gelesenen Neustartdatensatzes empfängt.
Rückgabewert
ClfsReadPreviousRestartArea gibt STATUS_SUCCESS zurück, wenn sie erfolgreich ist; andernfalls wird eine der fehlercodes zurückgegeben, die in Ntstatus.h definiert sind. Wenn keine vorherigen Neustartbereiche vorhanden sind, wird der Rückgabewert STATUS_LOG_START_OF_LOG.
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.
Clients hängen Neustartdatensätze an ein CLFS-Protokoll an, indem sie ClfsWriteRestartAreaaufrufen.
Mit dem ReadPreviousLogRestartArea Routine können Clients eine Form von Fuzzyprüfpunkting implementieren. Der Prüfpunktstatus kann z. B. aus den Protokolldatensätzen bestehen, die durch zwei oder mehr Neustartdatensätze getrennt sind.
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 |