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 |