Función SetVolumeMountPointW (winbase.h)
Asocia un volumen a una letra de unidad o a un directorio de otro volumen.
Sintaxis
BOOL SetVolumeMountPointW(
[in] LPCWSTR lpszVolumeMountPoint,
[in] LPCWSTR 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 Asignar un nombre a 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 |