Função ClfsQueryLogFileInformation (wdm.h)

A rotina 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.

Retornar valor

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

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, Ntddk.h, Ntifs.h)
Biblioteca Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Confira também

ClfsSetLogFileInformation