Funzione ClfsReadNextLogRecord (wdm.h)

Articolo
02/27/2024

La routine ClfsReadNextLogRecord legge il record successivo in una sequenza, rispetto al record corrente in un contesto di lettura.

Sintassi

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
);

Parametri

[in, out] pvReadContext

Puntatore a un contesto di lettura ottenuto in precedenza dal chiamante ClfsReadLogRecord o ClfsReadRestartArea.

[out] ppvBuffer

Puntatore a una variabile che riceve un puntatore a un buffer che contiene i dati del record.

[out] pcbBuffer

Puntatore a una variabile tipizzata ULONG che riceve le dimensioni, in byte, del buffer a cui punta *ppvBuffer. Si tratta della lunghezza del buffer di dati della lettura del record.

[in, out] peRecordType

Puntatore a una variabile di tipo CLFS_RECORD_TYPE. Il chiamante deve impostare questo parametro su uno dei valori seguenti.

Valore	Record che verrà letto
ClfsDataRecord	Record di dati successivo.
ClfsRestartRecord	Record di riavvio successivo.
ClfsClientRecord	Record successivo che è un record di dati o un record di riavvio.

[in, optional] plsnUser

Puntatore a una struttura CLFS_LSN che fornisce l'LSN del record da leggere. Il record specificato viene letto anziché il record che sarebbe stato letto in base alla modalità (ClfsContextUndoNext, ClfsContextPrevious o ClfsContextForward) del contesto di lettura (pvReadContext). LSN fornito in plsnUser deve essere minore dell'LSN corrente del contesto di lettura. Questo parametro può essere NULL.

[out] plsnUndoNext

Puntatore a una struttura CLFS_LSN che riceve l'LSN di annullamento successivo del record letto.

[out] plsnPrevious

Puntatore a una struttura CLFS_LSN che riceve l'LSN precedente del record letto.

[out] plsnRecord

Puntatore a una struttura CLFS_LSN che riceve l'LSN del record letto.

Valore restituito

ClfsReadNextLogRecord restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.

Commenti

Per una spiegazione dei concetti e della terminologia CLFS, vedere Common Log File System.

Per informazioni sulla lettura dei record dai flussi CLFS, vedere Lettura di record di dati da un Stream CLFS e lettura di record di riavvio da un Stream CLFS.

I contesti di lettura non sono thread-safe. I client sono responsabili della serializzazione dell'accesso ai contesti di lettura.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Server 2003 R2, Windows Vista e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	wdm.h (include Wdm.h)
Libreria	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

Vedi anche

CLFS_LSN

ClfsReadLogRecord

ClfsReadRestartArea

Condividi tramite