Funzione ClfsReadNextLogRecord (wdm.h)

Articolo
02/07/2025

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 chiamando ClfsReadLogRecord o ClfsReadRestartArea.

[out] ppvBuffer

Puntatore a una variabile che riceve un puntatore a un buffer contenente 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 del record letto.

[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 invece del record che sarebbe stato letto in base alla modalità (ClfsContextUndoNext, ClfsContextPreviouso ClfsContextForward) del contesto di lettura (pvReadContext). L'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 di 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.

Osservazioni

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

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

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

Fabbisogno

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

Vedere anche

CLFS_LSN

ClfsReadLogRecord

ClfsReadRestartArea

Condividi tramite