Función SetVolumeMountPointA (winbase.h)

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

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 los directorios ocultos y del sistema, así como para otros directorios, y se produce para los 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 sucede, 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.

Technology 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

DeleteVolumeMountPoint

GetVolumeNameForVolumeMountPoint

GetVolumePathName

Carpetas montadas

Funciones de administración de volúmenes