Função ClfsAdvanceLogBase (wdm.h)

Artigo
02/07/2025

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 de 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.

Valor de retorno

ClfsAdvanceLogBase retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retorna um dos códigos de erro definidos em Ntstatus.h.

Observações

ClfsAdvanceLogBase não grava nenhum registro no log do 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 LSN base novo no armazenamento estável.

ClfsAdvanceLogBase não verifica se o LSN fornecido em plsnBase é, na verdade, o LSN de um dos registros no fluxo. Se o chamador definir plsnBase para 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
de cliente com suporte mínimo	Disponível no Windows Server 2003 R2, Windows Vista e versões posteriores do Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	wdm.h (inclua Wdm.h)
biblioteca	Clfs.lib
de DLL	Clfs.sys
IRQL	<= APC_LEVEL

Consulte também

ClfsWriteRestartArea

Partilhar via