Función FindFirstVolumeA (winbase.h)
Recupera el nombre de un volumen en un equipo. FindFirstVolume se usa para comenzar a examinar los volúmenes de un equipo.
Sintaxis
HANDLE FindFirstVolumeA(
[out] LPSTR 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 para recibir la ruta de acceso GUID del volumen, en TCHAR.
Valor devuelto
Si la función se realiza 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 volumen 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
| Requisito | Value |
|---|---|
| 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 | winbase.h (incluye Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |