Función GetVolumePathNamesForVolumeNameA (winbase.h)
Recupera una lista de letras de unidad y rutas de acceso de carpetas montadas para el volumen especificado.
Sintaxis
BOOL GetVolumePathNamesForVolumeNameA(
[in] LPCSTR lpszVolumeName,
[out] LPCH lpszVolumePathNames,
[in] DWORD cchBufferLength,
[out] PDWORD lpcchReturnLength
);
Parámetros
[in] lpszVolumeName
Ruta de acceso guid de volumen para el volumen. Una ruta de acceso GUID de volumen tiene el formato "\?\Volume{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}".
[out] lpszVolumePathNames
Puntero a un búfer que recibe la lista de letras de unidad y rutas de acceso de carpeta montadas. La lista es una matriz de cadenas terminadas en null terminadas por un carácter NULL adicional. Si el búfer no es lo suficientemente grande como para contener la lista completa, el búfer contiene la mayor parte de la lista posible.
[in] cchBufferLength
Longitud del búfer lpszVolumePathNames , en TCHAR, incluidos todos los caracteres NULL .
[out] lpcchReturnLength
Si la llamada se realiza correctamente, este parámetro es el número de TCHAR copiados en el búfer lpszVolumePathNames . De lo contrario, este parámetro es el tamaño del búfer necesario para contener la lista completa, 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 el búfer no es lo suficientemente grande como para contener la lista completa, el código de error se ERROR_MORE_DATA y el parámetro lpcchReturnLength recibe el tamaño de búfer necesario.
Comentarios
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 (incluya Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |