Función GetVolumeNameForVolumeMountPointW (fileapi.h)
Recupera la ruta de acceso del GUID del volumen asociado al punto de montaje del volumen especificado (letra de unidad, ruta de acceso del GUID del volumen o carpeta montada).
Sintaxis
BOOL GetVolumeNameForVolumeMountPointW(
[in] LPCWSTR lpszVolumeMountPoint,
[out] LPWSTR lpszVolumeName,
[in] DWORD cchBufferLength
);
Parámetros
[in] lpszVolumeMountPoint
Puntero a una cadena que contiene la ruta de acceso de una carpeta montada (por ejemplo, "Y:\MountX\") o una letra de unidad (por ejemplo, "X:\"). La cadena debe terminar con una barra diagonal inversa final ('\').
[out] lpszVolumeName
Puntero a una cadena que recibe la ruta de acceso del GUID del volumen. Esta ruta de acceso tiene el formato "\\?\Volume{GUID}\" donde GUID es un GUID que identifica el volumen. Si hay más de una ruta de acceso GUID de volumen para el volumen, solo se devuelve la primera de la memoria caché del administrador de montaje.
[in] cchBufferLength
Longitud del búfer de salida, en TCHAR. Un tamaño razonable para que el búfer admita la ruta de acceso GUID de volumen más grande posible es de 50 caracteres.
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.
Comentarios
Use GetVolumeNameForVolumeMountPoint para obtener una ruta de acceso GUID de volumen para su uso con funciones como SetVolumeMountPoint y FindFirstVolumeMountPoint que requieren una ruta de acceso GUID de volumen como parámetro de entrada. Para obtener más información sobre las rutas de acceso GUID del volumen, consulte Nomenclatura de un volumen.
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) | No |
SMB no admite funciones de administración de volúmenes.
Los volúmenes reFS no admiten puntos de montaje.
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 |