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 |