Função ClfsReadRestartArea (wdm.h)
A rotina de 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.
Valor de retorno
ClfsReadRestartArea retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retorna um dos códigos de erro definidos em Ntstatus.h.
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.
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 |