Функция SetVolumeMountPointA (winbase.h)

Статья
03/08/2023

Связывает том с буквой диска или каталогом на другом томе.

Синтаксис

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

Параметры

[in] lpszVolumeMountPoint

Путь пользовательского режима, связанный с томом. Это может быть буква диска (например, "X:\") или каталог на другом томе (например, "Y:\MountX"). Строка должна заканчиваться обратной косой чертой ('').

[in] lpszVolumeName

Путь GUID тома для тома. Эта строка должна иметь вид \\?\Volume{GUID}, где GUID — это GUID , идентифицирующий том. Параметр "\\?" отключает синтаксический анализ пути и игнорируется как часть пути, как описано в разделе Именование тома.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Если параметр lpszVolumeMountPoint содержит путь к подключенной папке, GetLastError возвращает ERROR_DIR_NOT_EMPTY, даже если каталог пуст.

Связывание тома с каталогом с файлами или подкаталогами в нем является ошибкой. Эта ошибка возникает для системных и скрытых каталогов, а также других каталогов, а также для системных и скрытых файлов.

При создании подключенных папок на томе на кластеризованном диске они могут быть неожиданно удалены при определенных обстоятельствах. Сведения о создании и настройке подключенных папок для обеспечения того, чтобы этого не произошло, см. в разделе Проблемы с подключением диска и диска кластера.

В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.

Технология	Поддерживается
Протокол SMB 3.0	Нет
SMB 3.0 Transparent Failover (TFO)	Нет
SMB 3.0 с масштабируемыми общими папками (SO)	Нет
Файловая система общего тома кластера (CSVFS)	Нет
Восстанавливаемая файловая система (ReFS)	Нет

SMB не поддерживает функции управления томами. Для CsvFS новая точка подключения не будет реплицироваться на другие узлы в кластере.

Примеры

Пример см. в разделе Создание подключенной папки.

Примечание

Заголовок winbase.h определяет SetVolumeMountPoint в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll