Función FindNextVolumeW (fileapi.h)

  • Artículo

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.

Tecnología Compatible
Protocolo Bloque de mensajes del servidor (SMB) 3.0 No
Conmutación por error transparente (TFO) de SMB 3.0 No
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) No
Sistema de archivos de Volumen compartido de clúster (CsvFS) Sí
Sistema de archivos resistente a errores (ReFS) Sí
 

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

Ejemplos

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

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado fileapi.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

FindFirstVolume

FindVolumeClose

Carpetas montadas

Funciones de administración de volúmenes