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 |