Función FindFirstVolumeW (fileapi.h)

  • Artículo

Recupera el nombre de un volumen en un equipo. FindFirstVolume se usa para comenzar a examinar los volúmenes de un equipo.

Sintaxis

HANDLE FindFirstVolumeW(
  [out] LPWSTR lpszVolumeName,
  [in]  DWORD  cchBufferLength
);

Parámetros

[out] lpszVolumeName

Puntero a un búfer que recibe una cadena terminada en null que especifica una ruta de acceso GUID de volumen para el primer volumen que se encuentra.

[in] cchBufferLength

Longitud del búfer que se va a recibir la ruta de acceso del GUID del volumen, en TCHAR.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador de búsqueda usado en una llamada posterior a las funciones FindNextVolume y FindVolumeClose .

Si la función no encuentra ningún volumen, el valor devuelto es el código de error INVALID_HANDLE_VALUE . Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función FindFirstVolume abre un identificador de búsqueda de volúmenes y devuelve información sobre el primer volumen encontrado en un equipo. Una vez establecido el identificador de búsqueda, puede usar la función FindNextVolume para buscar otros volúmenes. Cuando el identificador de búsqueda ya no sea necesario, ciérrelo mediante la función FindVolumeClose .

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 (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

FindNextVolume

FindVolumeClose

Carpetas montadas

Funciones de administración de volúmenes