Función SetVolumeMountPointA (winbase.h)

Artículo
08/27/2023

Asocia un volumen a una letra de unidad o a un directorio de 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 para el volumen. Esta cadena debe tener el formato "\\?\Volume{GUID}", donde GUID es un GUID 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 Nomenclatura de un volumen.

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 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.

Comentarios

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 en clúster, 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 se produce, consulte Problemas de conexión de disco y unidad de clúster.

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

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)	No
Sistema de archivos resistente a errores (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 Convenciones para prototipos de función.

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	winbase.h (incluye Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll