Funzione ClfsAdvanceLogBase (wdm.h)

  • Articolo

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

Vedi anche

ClfsWriteRestartArea