Función GetVolumePathNamesForVolumeNameW (fileapi.h)

Recupera una lista de letras de unidad y rutas de acceso de carpetas montadas para el volumen especificado.

Sintaxis

BOOL GetVolumePathNamesForVolumeNameW(
  [in]  LPCWSTR lpszVolumeName,
  [out] LPWCH   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	fileapi.h (incluye Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

Carpetas montadas

Funciones de administración de volúmenes