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

Статья
11/20/2024

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

Синтаксис

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, даже если каталог пуст.

Замечания

Если эта функция используется для связывания тома с каталогом в другом томе, связанный каталог вызывается подключенной папкой.

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

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

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

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

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

Примеры

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	winbase.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll