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

Retornar valor

ClfsReadPreviousRestartArea retornará STATUS_SUCCESS se for bem-sucedido; caso contrário, retornará 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.

Comentários

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 Stream CLFS e Lendo registros de reinicialização de um Stream 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 ReadPreviousLogRestartArea , os clientes podem implementar uma forma de ponto de verificação difuso. Por exemplo, o estado de ponto de verificação pode consistir nos registros de log delimitados por dois ou mais registros de reinicialização.

Requisitos

Confira também

CLFS_LSN

ClfsReadRestartArea

ClfsWriteRestartArea