ClfsReadNextLogRecord-Funktion (wdm.h)

  • Artikel

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 von ClfsReadLogRecord oder ClfsReadRestartArea abgerufen 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-typisierte Variable, die die Größe des Puffers in Bytes empfängt, auf den *ppvBuffer verweist. Dies ist die Länge des Datenpuffers des gelesenen Datensatzes.

[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, bei dem es sich entweder um einen Datensatz oder einen Neustartdatensatz handelt.

[in, optional] plsnUser

Ein Zeiger auf eine CLFS_LSN Struktur, die den LSN des zu lesenden Datensatzes bereitstellt. Der angegebene Datensatz wird gelesen anstelle des Datensatzes, der gemäß dem Modus (ClfsContextUndoNext, ClfsContextPrevious oder ClfsContextForward) des Lesekontexts (pvReadContext) gelesen worden wäre. 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 nächsten LSN des gelesenen Datensatzes empfängt.

[out] plsnPrevious

Ein Zeiger auf eine CLFS_LSN-Struktur , die die vorherige 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 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 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.

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

ClfsReadLogRecord

ClfsReadRestartArea