Função ClfsReadRestartArea (wdm.h)

A rotina ClfsReadRestartArea lê o registro de reinicialização que foi gravado mais recentemente em um fluxo CLFS especificado.

Sintaxe

CLFSUSER_API NTSTATUS ClfsReadRestartArea(
  [in, out] PVOID     pvMarshalContext,
  [out]     PVOID     *ppvRestartBuffer,
  [out]     PULONG    pcbRestartBuffer,
  [out]     PCLFS_LSN plsn,
  [out]     PVOID     *ppvReadContext
);

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.

[out] ppvRestartBuffer

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

[out] pcbRestartBuffer

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

[out] plsn

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

[out] ppvReadContext

Um ponteiro para uma variável que recebe um ponteiro para um contexto de leitura opaco. O chamador pode passar esse contexto para ClfsReadPreviousRestartArea ou ClfsReadNextLogRecord. Quando o chamador terminar de usar o contexto de leitura, ele deverá liberar o contexto chamando ClfsTerminateReadLog.

Retornar valor

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

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.

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 (include Wdm.h)
Biblioteca	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

Confira também

ClfsCreateMarshallingArea

ClfsReadNextLogRecord

ClfsReadPreviousRestartArea

ClfsTerminateReadLog