Funzione ClfsReadPreviousRestartArea (wdm.h)
La routine ClfsReadPreviousRestartArea legge il record di riavvio precedente rispetto al record corrente in un contesto di lettura.
Sintassi
CLFSUSER_API NTSTATUS ClfsReadPreviousRestartArea(
[in] PVOID pvReadContext,
[out] PVOID *ppvRestartBuffer,
[out] PULONG pcbRestartBuffer,
[out] PCLFS_LSN plsnRestart
);
Parametri
[in] pvReadContext
Puntatore a un contesto di lettura ottenuto da una chiamata precedente a ClfsReadRestartArea.
[out] ppvRestartBuffer
Puntatore a una variabile che riceve un puntatore al buffer di dati del record di riavvio letto.
[out] pcbRestartBuffer
Puntatore a una variabile tipizzata ULONG che riceve le dimensioni, in byte, del buffer a cui punta *ppvRestartBuffer. Si tratta della lunghezza del buffer di dati del record di riavvio letto.
[out] plsnRestart
Puntatore a una struttura CLFS_LSN che riceve l'LSN precedente del record di riavvio letto.
Valore restituito
ClfsReadPreviousRestartArea restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h. Se non sono presenti aree di riavvio precedenti, il valore restituito è STATUS_LOG_START_OF_LOG.
Commenti
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 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.
I client aggiungono record di riavvio a un log CLFS chiamando ClfsWriteRestartArea.
Con la routine ReadPreviousLogRestartArea , i client possono implementare una forma di checkpoint fuzzy. Ad esempio, lo stato del checkpoint può essere costituito dai record di log delimitati da due o più record di riavvio.
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 |