Função ClfsSetLogFileInformation (wdm.h)

Artigo
02/07/2025

A rotina ClfsSetLogFileInformation define metadados e informações de estado para um fluxo especificado e seu log físico subjacente.

Sintaxe

CLFSUSER_API NTSTATUS ClfsSetLogFileInformation(
  [in] PLOG_FILE_OBJECT           plfoLog,
  [in] CLFS_LOG_INFORMATION_CLASS eInformationClass,
  [in] PVOID                      pinfoBuffer,
  [in] ULONG                      cbBuffer
);

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 CLFS_LOG_INFORMATION_CLASS que especifica a classe de informações que está sendo definida.

[in] pinfoBuffer

Um ponteiro para um buffer que fornece as informações de log. A estrutura desse buffer varia de acordo com a classe de informações especificada por eInformationClass. A tabela a seguir mostra a relação entre a classe de informações e o tipo de 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

[in] cbBuffer

O tamanho, em bytes, do buffer apontado por pinfoBuffer .

Valor de retorno

ClfsSetLogFileInformation 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 (inclua Wdm.h)
biblioteca	Clfs.lib
de DLL	Clfs.sys
IRQL	<= APC_LEVEL