Função ClfsReadNextLogRecord (wdm.h)

Artigo
02/07/2025

A rotina de 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, ClfsContextPreviousou ClfsContextForward) do contexto de leitura (pvReadContext). O LSN fornecido em plsnUser deve ser menor que o LSN atual do contexto de leitura. Esse parâmetro pode ser NULL.

[out] plsnUndoNext

Um ponteiro para uma estrutura CLFS_LSN que recebe o LSN de desfazer do registro 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.

Valor de retorno

ClfsReadNextLogRecord 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

Consulte também

CLFS_LSN

ClfsReadLogRecord

ClfsReadRestartArea

Compartilhar via