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 | |
ClfsLogBasicInformationPhysical | |
ClfsLogNameInformation | |
ClfsLogPhysicalNameInformation | |
ClfsLogStreamIdentifierInformation |
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 |