Função ClfsMgmtTailAdvanceFailure (wdm.h)

Artigo
02/07/2025

A rotina de ClfsMgmtTailAdvanceFailure notifica o gerenciamento CLFS de que o cliente não pôde avançar na parte final do log.

Sintaxe

CLFSUSER_API NTSTATUS ClfsMgmtTailAdvanceFailure(
  [in] CLFS_MGMT_CLIENT Client,
  [in] NTSTATUS         Reason
);

Parâmetros

[in] Client

Um ponteiro para o cliente. Esse é o valor obtido por meio de uma chamada para a rotina de ClfsMgmtRegisterManagedClient.

[in] Reason

Um valor que indica por que a parte final do log não pôde ser avançada.

Valor de retorno

A rotina de ClfsMgmtTailAdvanceFailure retorna um dos seguintes valores NTSTATUS:

Código de retorno	Descrição
STATUS_SUCCESS	O gerenciamento do CLFS processou a notificação de que a parte final do log não pôde ser avançada.
STATUS_INVALID_PARAMETER	Um valor de NULL foi fornecido para o parâmetro do cliente.
STATUS_INVALID_PARAMETER_1	O valor fornecido para o parâmetro Client não representa um cliente válido.

Observações

Se um cliente não puder avançar a parte final do log para ou além do LSN solicitado, o cliente deverá chamar o ClfsMgmtTailAdvanceFailure rotina para indicar que ele não é capaz de avançar sua cauda. Até que o cliente mova sua cauda conforme solicitado ou chame o rotina de ClfsMgmtTailAdvanceFailure, o cliente não receberá nenhuma solicitação adicional para mover sua cauda.

O valor do parâmetro Reason é passado de volta para o cliente como o valor do parâmetro OperationStatus quando a função ClfsLogGrowthCompleteCallback é invocada.

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

ClfsMgmtRegisterManagedClient

Compartilhar via