Compartilhar via


Função ClfsReadPreviousRestartArea (wdm.h)

A rotina ClfsReadPreviousRestartArea lê o registro de reinicialização anterior em relação ao registro atual em um contexto de leitura.

Sintaxe

CLFSUSER_API NTSTATUS ClfsReadPreviousRestartArea(
  [in]  PVOID     pvReadContext,
  [out] PVOID     *ppvRestartBuffer,
  [out] PULONG    pcbRestartBuffer,
  [out] PCLFS_LSN plsnRestart
);

Parâmetros

[in] pvReadContext

Um ponteiro para um contexto de leitura obtido por uma chamada anterior para ClfsReadRestartArea .

[out] ppvRestartBuffer

Um ponteiro para uma variável que recebe um ponteiro para o buffer de dados do registro de reinicialização que é lido.

[out] pcbRestartBuffer

Um ponteiro para uma variável do tipo ULONG que recebe o tamanho, em bytes, do buffer apontado por *ppvRestartBuffer. Esse é o comprimento do buffer de dados do registro de reinicialização lido.

[out] plsnRestart

Um ponteiro para uma estrutura CLFS_LSN que recebe o LSN anterior do registro de reinicialização que foi lido.

Valor de retorno

ClfsReadPreviousRestartArea retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retorna um dos códigos de erro definidos em Ntstatus.h. Se não houver áreas de reinicialização anteriores, o valor retornado será STATUS_LOG_START_OF_LOG.

Observações

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

Para obter informações sobre como ler registros de fluxos CLFS, consulte Lendo registros de dados de um de fluxo CLFS e lendo registros de reinicialização de um fluxo CLFS.

Os contextos de leitura não são thread-safe. Os clientes são responsáveis por serializar o acesso a contextos de leitura.

Os clientes acrescentam registros de reinicialização a um log CLFS chamando ClfsWriteRestartArea.

Com a rotina de ReadPreviousLogRestartArea, os clientes podem implementar uma forma de ponto de verificação difuso. Por exemplo, o estado do ponto de verificação pode consistir nos registros de log delimitados por dois ou mais registros de reinicialização.

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

CLFS_LSN

ClfsReadRestartArea

ClfsWriteRestartArea