Función FilterInstanceGetInformation (fltuser.h)

Artículo
02/26/2024

La función FilterInstanceGetInformation devuelve varios tipos de información sobre una instancia de minifiltro.

Sintaxis

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 devuelto por una llamada anterior a FilterInstanceCreate.

[in] dwInformationClass

Tipo de estructura de información de instancia devuelta. Este parámetro debe contener uno de los valores siguientes.

Valor	Significado
InstanceBasicInformation	Devuelve una estructura de INSTANCE_BASIC_INFORMATION para la instancia de .
InstanceFullInformation	Devuelve una estructura de INSTANCE_FULL_INFORMATION para la instancia.
InstancePartialInformation	Devuelve una estructura de INSTANCE_PARTIAL_INFORMATION para la instancia.
InstanceAggregateStandardInformation	Devuelve una estructura de INSTANCE_AGGREGATE_STANDARD_INFORMATION para la instancia. La parte LegacyFilter de la estructura se utiliza a partir de Windows 8. Esta estructura 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 lpBuffer apunta si la llamada a FilterInstanceGetInformation se realiza correctamente. Este parámetro es obligatorio y no puede ser NULL.

Valor devuelto

FilterInstanceGetInformation 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 InstanceAggregateStandardInformation se especifica para un sistema operativo antes de Windows Vista, FilterInstanceGetInformation devuelve este valor HRESULT.

Comentarios

Dado un identificador a una instancia de minifiltro, esta rutina devuelve información sobre la instancia de minifiltro. El tipo de información de instancia devuelta viene determinado por el parámetro dwInformationClass .

FilterInstanceGetInformation es el equivalente Win32 de FltGetInstanceInformation.