Función FilterVolumeFindNext (fltuser.h)

Artículo
03/09/2023

La función FilterVolumeFindNext continúa una búsqueda de volúmenes iniciada por una llamada a FilterVolumeFindFirst.

Sintaxis

HRESULT FilterVolumeFindNext(
  [in]  HANDLE                          hVolumeFind,
  [in]  FILTER_VOLUME_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                          lpBuffer,
  [in]  DWORD                           dwBufferSize,
  [out] LPDWORD                         lpBytesReturned
);

Parámetros

[in] hVolumeFind

Identificador de búsqueda por volumen devuelto por una llamada anterior a FilterVolumeFindFirst.

[in] dwInformationClass

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

Valor	Significado
FilterVolumeBasicInformation	El búfer al que apunta el parámetro lpBuffer recibe una estructura de FILTER_VOLUME_BASIC_INFORMATION para el volumen.
FilterVolumeStandardInformation	El búfer al que apunta el parámetro lpBuffer recibe una estructura de FILTER_VOLUME_STANDARD_INFORMATION para el volumen. 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 FilterVolumeFindNext se realiza correctamente. Este parámetro es obligatorio y no puede ser NULL.

Valor devuelto

FilterVolumeFindNext devuelve S_OK si devuelve correctamente información de volumen. 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 FilterVolumeStandardInformation para un sistema operativo antes de Windows Vista, FilterVolumeFindNext devuelve este valor HRESULT.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	No se encontraron más volúmenes en la lista de volúmenes conocidos para el administrador de filtros.

Comentarios

Una vez establecido el identificador de búsqueda llamando a FilterVolumeFindFirst, use la función FilterVolumeFindNext para buscar otros volúmenes. FilterVolumeFindNext busca un volumen por llamada.

Tenga en cuenta que al usar FilterVolumeFindFirst y FilterVolumeFindNext para enumerar la lista de volúmenes conocidos para el administrador de filtros, es posible que dos o más de los volúmenes de la lista tengan el mismo nombre. Para obtener más información, vea Descripción de las enumeraciones de volúmenes con nombres de volumen duplicados.