Función SetVolumeMountPointA (winbase.h)

Artículo
11/20/2024

Asocia un volumen a una letra de unidad o un directorio en otro volumen.

Sintaxis

BOOL SetVolumeMountPointA(
  [in] LPCSTR lpszVolumeMountPoint,
  [in] LPCSTR lpszVolumeName
);

Parámetros

[in] lpszVolumeMountPoint

Ruta de acceso del modo de usuario que se va a asociar al volumen. Puede ser una letra de unidad (por ejemplo, "X:\") o un directorio en otro volumen (por ejemplo, "Y:\MountX\"). La cadena debe terminar con una barra diagonal inversa final ('\').

[in] lpszVolumeName

Ruta de acceso GUID de volumen. Esta cadena debe tener el formato "\\?\Volume{GUID}\" donde GUID es un GUID de que identifica el volumen. "\\?\" desactiva el análisis de la ruta de acceso y se omite como parte de la ruta de acceso, como se describe en Asignar nombre a un volumen.

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 parámetro lpszVolumeMountPoint contiene una ruta de acceso a una carpeta montada, GetLastError devuelve ERROR_DIR_NOT_EMPTY, incluso si el directorio está vacío.

Observaciones

Cuando esta función se usa para asociar un volumen a un directorio de otro volumen, el directorio asociado se denomina carpeta montada .

Es un error asociar un volumen a un directorio que tiene archivos o subdirectorios en él. Este error se produce para directorios ocultos y del sistema, así como para otros directorios, y se produce para archivos ocultos y del sistema.

Cuando se crean carpetas montadas en un volumen en un disco agrupado, se pueden eliminar inesperadamente en determinadas circunstancias. Para obtener información sobre cómo crear y configurar carpetas montadas para asegurarse de que esto no sucede, consulte Problemas de conexión de unidad y disco de clúster.

IIn 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)	No
Sistema de archivos resistente (ReFS)	No

SMB no admite funciones de administración de volúmenes. Para CsvFS, un nuevo punto de montaje no se replicará en los demás nodos del clúster.

Ejemplos

Para obtener un ejemplo, vea Crear una carpeta montada.

Nota

El encabezado winbase.h define SetVolumeMountPoint como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

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	winbase.h (incluya Windows.h)
biblioteca de	Kernel32.lib
DLL de	Kernel32.dll