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

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

CLFS_LSN

ClfsReadRestartArea

ClfsWriteRestartArea