Función GetVolumeNameForVolumeMountPointW (fileapi.h)

  • Artículo

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

Vea también

DeleteVolumeMountPoint

GetVolumePathName

Carpetas montadas

SetVolumeMountPoint

Funciones de administración de volúmenes