ClfsReadNextLogRecord-Funktion (wdm.h)
Die ClfsReadNextLogRecord Routine liest den nächsten Datensatz in einer Sequenz, relativ zum aktuellen Datensatz in einem Lesekontext.
Syntax
CLFSUSER_API NTSTATUS ClfsReadNextLogRecord(
[in, out] PVOID pvReadContext,
[out] PVOID *ppvBuffer,
[out] PULONG pcbBuffer,
[in, out] PCLFS_RECORD_TYPE peRecordType,
[in, optional] PCLFS_LSN plsnUser,
[out] PCLFS_LSN plsnUndoNext,
[out] PCLFS_LSN plsnPrevious,
[out] PCLFS_LSN plsnRecord
);
Parameter
[in, out] pvReadContext
Ein Zeiger auf einen Lesekontext, den der Aufrufer zuvor durch Aufrufen ClfsReadLogRecord oder ClfsReadRestartAreaabgerufen hat.
[out] ppvBuffer
Ein Zeiger auf eine Variable, die einen Zeiger auf einen Puffer empfängt, der die Datensatzdaten enthält.
[out] pcbBuffer
Ein Zeiger auf eine ULONG-Typvariable, die die Größe des Puffers in Bytes empfängt, auf den *ppvBufferverweist. Dies ist die Länge des Datenpuffers des Datensatzlesevorgangs.
[in, out] peRecordType
Ein Zeiger auf eine Variable vom Typ CLFS_RECORD_TYPE. Der Aufrufer muss diesen Parameter auf einen der folgenden Werte festlegen.
| Wert | Datensatz, der gelesen wird |
|---|---|
| ClfsDataRecord- | Der nächste Datensatz. |
| ClfsRestartRecord- | Der nächste Neustartdatensatz. |
| ClfsClientRecord- | Der nächste Datensatz, der entweder ein Datensatz oder ein Neustartdatensatz ist. |
[in, optional] plsnUser
Ein Zeiger auf eine CLFS_LSN Struktur, die den LSN des zu lesenden Datensatzes bereitstellt. Der angegebene Datensatz wird anstelle des Datensatzes gelesen, der gemäß dem Modus gelesen worden wäre (ClfsContextUndoNext, ClfsContextPreviousoder ClfsContextForward) des Lesekontexts (pvReadContext). Der in plsnUser bereitgestellte LSN muss kleiner als der aktuelle LSN des Lesekontexts sein. Dieser Parameter kann NULL-sein.
[out] plsnUndoNext
Ein Zeiger auf eine CLFS_LSN Struktur, die den rückgängig-nächsten LSN des gelesenen Datensatzes empfängt.
[out] plsnPrevious
Ein Zeiger auf eine CLFS_LSN-Struktur, die den vorherigen LSN des gelesenen Datensatzes empfängt.
[out] plsnRecord
Ein Zeiger auf eine CLFS_LSN Struktur, die den LSN des gelesenen Datensatzes empfängt.
Rückgabewert
ClfsReadNextLogRecord 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 |