Función FilterGetInformation (fltuser.h)

Artículo
08/23/2023

La función FilterGetInformation devuelve varios tipos de información sobre un minifiltro.

Sintaxis

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

Parámetros

[in] hFilter

Identificador devuelto por una llamada anterior a la función FilterCreate .

[in] dwInformationClass

Tipo de información solicitada. Este parámetro puede ser uno de los siguientes valores.

Value	Significado
FilterFullInformation	Devuelve una estructura de FILTER_FULL_INFORMATION para el minifiltro.
FilterAggregateBasicInformation	Devuelve una estructura de FILTER_AGGREGATE_BASIC_INFORMATION para el minifiltro. Este valor dwInformationClass está disponible a partir de Microsoft Windows Server 2003 con SP1 y Microsoft Windows XP con SP2 con el paquete acumulativo del administrador de filtros. Para obtener más información sobre el paquete acumulativo del administrador de filtros para Windows XP con SP2, vea el artículo 914882, " El paquete acumulativo del administrador de filtros para Windows XP SP2", en Microsoft Knowledge Base.
FilterAggregateStandardInformation	Devuelve una estructura FILTER_AGGREGATE_STANDARD_INFORMATION para cada minifiltro. La parte LegacyFilter de la estructura no se utiliza. Este valor dwInformationClass está disponible a partir de Windows Vista.

[out] lpBuffer

Puntero a un búfer asignado por el autor de la llamada que recibe la información solicitada. El tipo de la información devuelta en el búfer se define mediante el parámetro dwInformationClass .

[in] dwBufferSize

Tamaño, en bytes, del búfer al que apunta el parámetro lpBuffer . El autor de la llamada debe establecer este parámetro según el dwInformationClass especificado.

[out] lpBytesReturned

Puntero a una variable asignada por el autor de la llamada que recibe el número de bytes devueltos en el búfer al que apunta lpBuffer si la llamada a FilterGetInformation se realiza correctamente. Este parámetro es obligatorio y no puede ser NULL.

Valor devuelto

FilterGetInformation devuelve S_OK si se ejecuta correctamente. De lo contrario, devuelve un valor de error HRESULT, como uno de los siguientes:

Código devuelto	Descripción
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	El búfer al que apunta lpBuffer no es lo suficientemente grande como para contener la información solicitada. Cuando se devuelve este valor, lpBytesReturned contendrá el tamaño, en bytes, del búfer necesario para la estructura dwInformationClass especificada.
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)	Se especificó un valor no válido para el parámetro dwInformationClass . Por ejemplo, si se especifica FilterAggregateStandardInformation para un sistema operativo anterior a Windows Vista, FilterGetInformation devuelve este valor HRESULT.