Función FilterVolumeFindFirst (fltuser.h)

Artículo
08/23/2023

La función FilterVolumeFindFirst devuelve información sobre un volumen.

Sintaxis

HRESULT FilterVolumeFindFirst(
  [in]  FILTER_VOLUME_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                          lpBuffer,
  [in]  DWORD                           dwBufferSize,
  [out] LPDWORD                         lpBytesReturned,
  [out] PHANDLE                         lpVolumeFind
);

Parámetros

[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 FilterVolumeFindFirst se realiza correctamente. Este parámetro es obligatorio y no puede ser NULL.

[out] lpVolumeFind

Puntero a una variable asignada por el autor de la llamada que recibe un identificador de búsqueda para el minifiltro si la llamada a FilterVolumeFindFirst se realiza correctamente; de lo contrario, recibe INVALID_HANDLE_VALUE. Este identificador de búsqueda se puede usar en llamadas posteriores a FilterVolumeFindNext y FilterVolumeFindClose.

Valor devuelto

FilterVolumeFindFirst devuelve S_OK si devuelve correctamente información sobre un 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 anterior a Windows Vista, FilterVolumeFindFirst devuelve este valor HRESULT.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	No se encontró un volumen en la lista de volúmenes conocidos por el administrador de filtros.

Comentarios

Esta función FilterVolumeFindFirst se usa para comenzar a examinar los volúmenes conocidos para el administrador de filtros.

FilterVolumeFindFirst abre un identificador de búsqueda y devuelve información sobre el primer volumen encontrado en la lista de volúmenes conocidos para el administrador de filtros. Una vez establecido el identificador de búsqueda, use la función FilterVolumeFindNext para buscar otros volúmenes en la lista del administrador de filtros. Cuando el identificador de búsqueda ya no sea necesario, ciérrelo llamando a FilterVolumeFindClose.

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 volúmenes de la lista tengan el mismo nombre. Para obtener más información, consulte Descripción de las enumeraciones de volúmenes con nombres de volumen duplicados.