Função ClfsReadNextLogRecord (wdm.h)
A rotina ClfsReadNextLogRecord lê o próximo registro em uma sequência, em relação ao registro atual em um contexto de leitura.
Sintaxe
CLFSUSER_API NTSTATUS ClfsReadNextLogRecord(
[in, out] PVOID pvReadContext,
[out] PVOID *ppvBuffer,
[out] PULONG pcbBuffer,
[in, out] PCLFS_RECORD_TYPE peRecordType,
[in, optional] PCLFS_LSN plsnUser,
[out] PCLFS_LSN plsnUndoNext,
[out] PCLFS_LSN plsnPrevious,
[out] PCLFS_LSN plsnRecord
);
Parâmetros
[in, out] pvReadContext
Um ponteiro para um contexto de leitura que o chamador obteve anteriormente chamando ClfsReadLogRecord ou ClfsReadRestartArea.
[out] ppvBuffer
Um ponteiro para uma variável que recebe um ponteiro para um buffer que contém os dados de registro.
[out] pcbBuffer
Um ponteiro para uma variável do tipo ULONG que recebe o tamanho, em bytes, do buffer apontado por *ppvBuffer. Esse é o comprimento do buffer de dados do registro lido.
[in, out] peRecordType
Um ponteiro para uma variável do tipo CLFS_RECORD_TYPE. O chamador deve definir esse parâmetro como um dos valores a seguir.
| Valor | Registro que será lido |
|---|---|
| ClfsDataRecord | O próximo registro de dados. |
| ClfsRestartRecord | O próximo registro de reinicialização. |
| ClfsClientRecord | O próximo registro que é um registro de dados ou um registro de reinicialização. |
[in, optional] plsnUser
Um ponteiro para uma estrutura CLFS_LSN que fornece o LSN do registro a ser lido. O registro especificado é lido em vez do registro que teria sido lido de acordo com o modo (ClfsContextUndoNext, ClfsContextPrevious ou ClfsContextForward) do contexto de leitura (pvReadContext). O LSN fornecido em plsnUser deve ser menor que o LSN atual do contexto de leitura. Este parâmetro pode ser NULL.
[out] plsnUndoNext
Um ponteiro para uma estrutura CLFS_LSN que recebe o LSN de desfazer o próximo registro que é lido.
[out] plsnPrevious
Um ponteiro para uma estrutura CLFS_LSN que recebe o LSN anterior do registro que foi lido.
[out] plsnRecord
Um ponteiro para uma estrutura CLFS_LSN que recebe o LSN do registro que foi lido.
Retornar valor
ClfsReadNextLogRecord retornará STATUS_SUCCESS se for bem-sucedido; caso contrário, 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 (inclua Wdm.h) |
| Biblioteca | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |