Funzione ClfsAdvanceLogBase (wdm.h)
La routine ClfsAdvanceLogBase imposta l'LSN di base di un flusso CLFS.
Sintassi
CLFSUSER_API NTSTATUS ClfsAdvanceLogBase(
[in, out] PVOID pvMarshalContext,
[in] PCLFS_LSN plsnBase,
[in] ULONG fFlags
);
Parametri
[in, out] pvMarshalContext
Puntatore a un contesto opaco che rappresenta un'area di marshalling associata a un flusso CLFS. Il chiamante ottenuto in precedenza questo puntatore chiamando ClfsCreateMarshallingArea.
[in] plsnBase
Puntatore a una struttura CLFS_LSN che contiene il nuovo LSN di base. Questo parametro deve essere l'LSN di uno dei record nel flusso. Inoltre, questo parametro deve essere maggiore o uguale all'LSN di base corrente del flusso e minore o uguale all'ultimo LSN corrente del flusso.
[in] fFlags
Questo parametro è riservato per l'uso del sistema. I chiamanti devono impostare questo parametro su zero.
Valore restituito
ClfsAdvanceLogBase restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.
Osservazioni
ClfsAdvanceLogBase non scrive alcun record nel log CLFS; gli unici aggiornamenti al log si trovano nei metadati. Se si vuole aggiornare l'LSN di base e scrivere un record di riavvio in un flusso contemporaneamente, chiamare ClfsWriteRestartArea.
Quando possibile, CLFS evita di scrivere record di log in coda con LSN inferiore al nuovo LSN di base per l'archiviazione stabile.
ClfsAdvanceLogBase non verifica se l'LSN fornito in plsnBase è effettivamente l'LSN di uno dei record nel flusso. Se il chiamante imposta plsnBase su un LSN che non è l'LSN di uno dei record nel flusso, l'LSN di base del flusso verrà impostato su un valore senza significato.
Per una spiegazione dei concetti e della terminologia di CLFS, vedere Common Log File System.
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 |