Función FindNextVolumeW (fileapi.h)

Continúa una búsqueda de volúmenes iniciada por una llamada a la función FindFirstVolume. FindNextVolume busca un volumen por llamada.

Sintaxis

BOOL FindNextVolumeW(
  [in]  HANDLE hFindVolume,
  [out] LPWSTR lpszVolumeName,
  [in]  DWORD  cchBufferLength
);

Parámetros

[in] hFindVolume

Identificador de búsqueda de volumen devuelto por una llamada anterior a la función FindFirstVolume .

[out] lpszVolumeName

Puntero a una cadena que recibe la ruta de acceso GUID del volumen que se encuentra.

[in] cchBufferLength

Longitud del búfer que recibe la ruta de acceso GUID del volumen, en TCHAR.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError. Si no se encuentra ningún archivo coincidente, la función GetLastError devuelve el código de error ERROR_NO_MORE_FILES . En ese caso, cierre la búsqueda con la función FindVolumeClose .

Comentarios

Una vez establecido el identificador de búsqueda llamando a FindFirstVolume, puede usar la función FindNextVolume para buscar otros volúmenes.

No debe asumir ninguna correlación entre el orden de los volúmenes devueltos por estas funciones y el orden de los volúmenes que están en el equipo. En concreto, no asuma ninguna correlación entre el orden de los volúmenes y las letras de unidad asignadas por el BIOS (si existe) o el administrador de discos.

En Windows 8 y Windows Server 2012, esta función es compatible con las tecnologías siguientes.

SMB no admite funciones de administración de volúmenes.

Ejemplos

Para obtener un ejemplo, vea Mostrar rutas de acceso de volumen.

Requisitos

Vea también

FindFirstVolume

FindVolumeClose

Carpetas montadas

Funciones de administración de volúmenes