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 ha ottenuto in precedenza questo puntatore chiamando ClfsCreateMarshallingArea.
[in] plsnBase
Puntatore a una struttura CLFS_LSN contenente il nuovo LSN di base. Questo parametro deve essere 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.
Commenti
ClfsAdvanceLogBase non scrive record nel log CLFS; gli unici aggiornamenti al log sono nei metadati. Se si vuole aggiornare l'LSN di base e scrivere un record di riavvio in un flusso contemporaneamente, chiamare ClfsWriteRestartArea.
Se possibile, CLFS evita la scrittura di record di log in coda con reti LSN inferiori alla nuova LSN di base per l'archiviazione stabile.
ClfsAdvanceLogBase non verifica se l'LSN fornito in plsnBase è effettivamente 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 CLFS, vedere Common Log File System.
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 |