Función GetVolumePathNamesForVolumeNameW (fileapi.h)

Recupera una lista de letras de unidad y rutas de acceso de carpeta 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. Una ruta de acceso GUID de volumen es de la forma "\\?\Volume{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx}\".

[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 adicional NULL. 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 de lpszVolumePathNames, en WCHAR, incluidos todos los caracteres de NULL .

[out] lpcchReturnLength

Si la llamada se realiza correctamente, este parámetro es el número de WCHAR copiados en el búfer de lpszVolumePathNames. De lo contrario, este parámetro es el tamaño del búfer necesario para contener la lista completa, en WCHAR.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.

Si se produce un error en la función, 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.

Observaciones

En Windows 8 y Windows Server 2012, esta función es compatible con las siguientes tecnologías.

Tecnología	Soportado
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 (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	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	fileapi.h (incluya Windows.h)
biblioteca de	Kernel32.lib
DLL de	Kernel32.dll

Consulte también

carpetas montadas

funciones de administración de volúmenes de