Funzione ClfsReadRestartArea (wdm.h)

La routine ClfsReadRestartArea legge il record di riavvio scritto più di recente in un flusso CLFS specificato.

Sintassi

CLFSUSER_API NTSTATUS ClfsReadRestartArea(
  [in, out] PVOID     pvMarshalContext,
  [out]     PVOID     *ppvRestartBuffer,
  [out]     PULONG    pcbRestartBuffer,
  [out]     PCLFS_LSN plsn,
  [out]     PVOID     *ppvReadContext
);

Parametri

[in, out] pvMarshalContext

Puntatore a un contesto opaco che rappresenta un'area di marshalling associata a un flusso CLFS. Il chiamante ha ottenuto in precedenza questo puntatore chiamando ClfsCreateMarshallingArea.

[out] ppvRestartBuffer

Puntatore a una variabile che riceve un puntatore al buffer dati del record di riavvio.

[out] pcbRestartBuffer

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

[out] plsn

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

[out] ppvReadContext

Puntatore a una variabile che riceve un puntatore a un contesto di lettura opaco. Il chiamante può passare questo contesto a ClfsReadPreviousRestartArea o ClfsReadNextLogRecord. Al termine dell'uso del contesto di lettura, il chiamante deve liberare il contesto chiamando ClfsTerminateReadLog.

Valore restituito

ClfsReadRestartArea 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

ClfsCreateMarshallingArea

ClfsReadNextLogRecord

ClfsReadPreviousRestartArea

ClfsTerminateReadLog