Função ClfsAdvanceLogBase (wdm.h)

  • Artigo

A rotina ClfsAdvanceLogBase define o LSN base de um fluxo CLFS.

Sintaxe

CLFSUSER_API NTSTATUS ClfsAdvanceLogBase(
  [in, out] PVOID     pvMarshalContext,
  [in]      PCLFS_LSN plsnBase,
  [in]      ULONG     fFlags
);

Parâmetros

[in, out] pvMarshalContext

Um ponteiro para um contexto opaco que representa uma área de marshalling associada a um fluxo CLFS. O chamador obteve esse ponteiro anteriormente chamando ClfsCreateMarshallingArea.

[in] plsnBase

Um ponteiro para uma estrutura CLFS_LSN que contém o novo LSN base. Esse parâmetro deve ser o LSN de um dos registros no fluxo. Além disso, esse parâmetro deve ser maior ou igual ao LSN base atual do fluxo e menor ou igual ao LSN atual do fluxo.

[in] fFlags

Esse parâmetro é reservado para uso do sistema. Os chamadores devem definir esse parâmetro como zero.

Retornar valor

ClfsAdvanceLogBase retornará STATUS_SUCCESS se for bem-sucedido; caso contrário, retornará um dos códigos de erro definidos em Ntstatus.h.

Comentários

ClfsAdvanceLogBase não grava nenhum registro no log CLFS; as únicas atualizações para o log estão nos metadados. Se você quiser atualizar o LSN base e gravar um registro de reinicialização em um fluxo ao mesmo tempo, chame ClfsWriteRestartArea.

Sempre que possível, o CLFS evita gravar registros de log enfileirados que tenham LSNs menores que o novo LSN base no armazenamento estável.

ClfsAdvanceLogBase não marcar para ver se o LSN fornecido no plsnBase é, na verdade, o LSN de um dos registros no fluxo. Se o chamador definir plsnBase como um LSN que não seja o LSN de um dos registros no fluxo, o LSN base do fluxo será definido como um valor sem sentido.

Para obter uma explicação dos conceitos e terminologia do CLFS, consulte Common Log File System.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Server 2003 R2, Windows Vista e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho wdm.h (inclua Wdm.h)
Biblioteca Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Confira também

ClfsWriteRestartArea