Función FilterVolumeInstanceFindNext (fltuser.h)

Artículo
08/23/2023

La función FilterVolumeInstanceFindNext continúa una instancia del controlador de minifiltro o una búsqueda de controladores de filtro heredada iniciada por una llamada a FilterVolumeInstanceFindFirst.

Sintaxis

HRESULT FilterVolumeInstanceFindNext(
  [in]  HANDLE                     hVolumeInstanceFind,
  [in]  INSTANCE_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                     lpBuffer,
  [in]  DWORD                      dwBufferSize,
  [out] LPDWORD                    lpBytesReturned
);

Parámetros

[in] hVolumeInstanceFind

Identificador de búsqueda del controlador de filtro de volumen devuelto por una llamada anterior a FilterVolumeInstanceFindFirst.

[in] dwInformationClass

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

Valor	Significado
InstanceBasicInformation	Devuelve una estructura de INSTANCE_BASIC_INFORMATION para una instancia de minifiltro. Se omiten los controladores de filtro heredados.
InstanceFullInformation	Devuelve una estructura de INSTANCE_FULL_INFORMATION para una instancia de minifiltro. Se omiten los controladores de filtro heredados.
InstancePartialInformation	Devuelve una estructura de INSTANCE_PARTIAL_INFORMATION para una instancia de minifiltro. Se omiten los controladores de filtro heredados.
InstanceAggregateStandardInformation	Devuelve una estructura de INSTANCE_AGGREGATE_STANDARD_INFORMATION para la instancia. El miembro LegacyFilter de la estructura no se utiliza. 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 FilterVolumeInstanceFindNext se realiza correctamente. Este parámetro es obligatorio y no puede ser NULL.

Valor devuelto

FilterVolumeInstanceFindNext 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, FilterVolumeInstanceFindNext devuelve este valor HRESULT.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	No se encontraron más controladores de filtro en el volumen especificado.

Comentarios

FilterVolumeInstanceFindNext busca un controlador de filtro por llamada.

Una vez establecido el identificador de búsqueda llamando a FilterVolumeInstanceFindFirst, use la función FilterVolumeInstanceFindNext para buscar otros controladores de filtro que estén asociados al volumen especificado en la llamada a FilterVolumeInstanceFindFirst. Cuando el identificador de búsqueda ya no sea necesario, ciérrelo llamando a FilterVolumeInstanceFindClose.

A partir de Windows Vista, esta rutina puede devolver tanto la información del controlador de filtro heredado como la información de la instancia del controlador de minifiltro cuando el valor del parámetro dwInformationClass es InstanceAggregateStandardInformation. En el caso de los sistemas operativos anteriores, esta rutina no puede devolver información de filtro heredada porque la estructura de INSTANCE_AGGREGATE_STANDARD_INFORMATION no está disponible.