Função ClfsQueryLogFileInformation (wdm.h)

Artigo
02/07/2025

A rotina de ClfsQueryLogFileInformation retorna metadados e informações de estado para um fluxo CLFS especificado ou seu log físico subjacente ou ambos.

Sintaxe

CLFSUSER_API NTSTATUS ClfsQueryLogFileInformation(
  [in]  PLOG_FILE_OBJECT           plfoLog,
  [in]  CLFS_LOG_INFORMATION_CLASS eInformationClass,
        PVOID                      pinfoInputBuffer,
        ULONG                      cbinfoInputBuffer,
  [out] PVOID                      pinfoBuffer,
        PULONG                     pcbInfoBuffer
);

Parâmetros

[in] plfoLog

Um ponteiro para uma estrutura LOG_FILE_OBJECT que representa um fluxo CLFS. O chamador obteve esse ponteiro anteriormente chamando ClfsCreateLogFile.

[in] eInformationClass

Um valor da enumeração CLFS_LOG_INFORMATION_CLASS que especifica o tipo de informação que está sendo solicitada.

pinfoInputBuffer

Buffer de entrada opcional que é necessário para algumas classes de informações.

cbinfoInputBuffer

Comprimento em bytes de pinfoInputBuffer.

[out] pinfoBuffer

Um ponteiro para um buffer que recebe as informações de log. A estrutura desse buffer depende do valor de eInformationClass. A tabela a seguir mostra a relação entre a classe de informações e o tipo de dados do buffer.

Valor de eInformationClass	Tipo de buffer apontado por pinfoBuffer
ClfsLogBasicInformation	CLFS_INFORMATION
ClfsLogBasicInformationPhysical	CLFS_INFORMATION
ClfsLogNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogPhysicalNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogStreamIdentifierInformation	CLFS_STREAM_ID_INFORMATION

pcbInfoBuffer

Comprimento em bytes do buffer de informações de entrada.

Valor de retorno

ClfsQueryLogFileInformation 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.

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 (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca	Clfs.lib
de DLL	Clfs.sys
IRQL	<= APC_LEVEL

Consulte também

ClfsSetLogFileInformation

Compartilhar via