Função FilterInstanceGetInformation (fltuser.h)

Artigo
02/29/2024

A função FilterInstanceGetInformation retorna vários tipos de informações sobre uma instância de minifiltro.

Sintaxe

HRESULT FilterInstanceGetInformation(
  [in]  HFILTER_INSTANCE           hInstance,
  [in]  INSTANCE_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                     lpBuffer,
  [in]  DWORD                      dwBufferSize,
  [out] LPDWORD                    lpBytesReturned
);

Parâmetros

[in] hInstance

Identificador retornado por uma chamada anterior para FilterInstanceCreate.

[in] dwInformationClass

O tipo de estrutura de informações da instância retornada. Esse parâmetro deve conter um dos valores a seguir.

Valor	Significado
InstanceBasicInformation	Retornar uma estrutura de INSTANCE_BASIC_INFORMATION para a instância.
InstanceFullInformation	Retornar uma estrutura INSTANCE_FULL_INFORMATION para a instância.
InstancePartialInformation	Retornar uma estrutura de INSTANCE_PARTIAL_INFORMATION para a instância.
InstanceAggregateStandardInformation	Retornar uma estrutura de INSTANCE_AGGREGATE_STANDARD_INFORMATION para a instância. A parte LegacyFilter da estrutura é utilizada começando com Windows 8. Essa estrutura está disponível a partir do Windows Vista.

[out] lpBuffer

Ponteiro para um buffer alocado pelo chamador que recebe as informações solicitadas. O tipo das informações retornadas no buffer é definido pelo parâmetro dwInformationClass .

[in] dwBufferSize

Tamanho, em bytes, do buffer para o qual o parâmetro lpBuffer aponta. O chamador deve definir esse parâmetro de acordo com o dwInformationClass especificado.

[out] lpBytesReturned

Ponteiro para uma variável alocada pelo chamador que recebe o número de bytes retornados no buffer para o qual lpBuffer aponta se a chamada para FilterInstanceGetInformation for bem-sucedida. Esse parâmetro é necessário e não pode ser NULL.

Retornar valor

FilterInstanceGetInformation retornará S_OK se tiver êxito. Caso contrário, ele retornará um valor de erro HRESULT, como um dos seguintes:

Código de retorno	Descrição
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	O buffer apontado por lpBuffer não é grande o suficiente para conter as informações solicitadas. Quando esse valor é retornado, lpBytesReturned conterá o tamanho, em bytes, do buffer necessário para a estrutura dwInformationClass fornecida.
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)	Um valor inválido foi especificado para o parâmetro dwInformationClass . Por exemplo, se InstanceAggregateStandardInformation for especificado para um sistema operacional antes do Windows Vista, FilterInstanceGetInformation retornará esse valor HRESULT.

Comentários

Dado um identificador para uma instância de minifiltro, essa rotina retorna informações sobre a instância de minifiltro. O tipo de informações de instância retornadas é determinado pelo parâmetro dwInformationClass .

FilterInstanceGetInformation é o equivalente a Win32 de FltGetInstanceInformation.