Função FilterGetInformation (fltuser.h)

Artigo
08/23/2023

A função FilterGetInformation retorna vários tipos de informações sobre um minifiltro.

Sintaxe

HRESULT FilterGetInformation(
  [in]  HFILTER                  hFilter,
  [in]  FILTER_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                   lpBuffer,
  [in]  DWORD                    dwBufferSize,
  [out] LPDWORD                  lpBytesReturned
);

Parâmetros

[in] hFilter

Identificador retornado por uma chamada anterior para a função FilterCreate .

[in] dwInformationClass

Tipo de informação solicitada. Esse parâmetro deve usar um dos valores a seguir.

Valor	Significado
FilterFullInformation	Retornar uma estrutura de FILTER_FULL_INFORMATION para o minifiltro.
FilterAggregateBasicInformation	Retornar uma estrutura de FILTER_AGGREGATE_BASIC_INFORMATION para o minifiltro. Esse valor dwInformationClass está disponível a partir do Microsoft Windows Server 2003 com SP1 e Microsoft Windows XP com SP2 com rollup do gerenciador de filtros. Para obter mais informações sobre o pacote cumulativo cumulativo de atualizações do gerenciador de filtros para Windows XP com SP2, consulte o artigo 914882, " O pacote cumulativo de atualizações do gerenciador de filtros para Windows XP SP2", na Base de Dados de Conhecimento Microsoft.
FilterAggregateStandardInformation	Retornar uma estrutura FILTER_AGGREGATE_STANDARD_INFORMATION para cada minifiltro. A parte LegacyFilter da estrutura não é utilizada. Esse valor dwInformationClass 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 FilterGetInformation for bem-sucedida. Esse parâmetro é necessário e não pode ser NULL.

Valor retornado

FilterGetInformation 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 FilterAggregateStandardInformation for especificado para um sistema operacional antes do Windows Vista, FilterGetInformation retornará esse valor HRESULT.