Share via

Метод IVdsVolumeMF::AddAccessPath (vds.h)

  • Статья

[Начиная с Windows 8 и Windows Server 2012, COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]

Добавляет путь доступа.

Синтаксис

HRESULT AddAccessPath(
  [in] LPWSTR pwszPath
);

Параметры

[in] pwszPath

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

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

Этот метод может возвращать стандартные значения HRESULT, такие как E_INVALIDARG или E_OUTOFMEMORY, а также возвращаемые значения VDS. Он также может возвращать коды преобразованных системных ошибок с помощью макроса HRESULT_FROM_WIN32 . Ошибки могут возникать из самого VDS или из используемого базового поставщика VDS . Возможные возвращаемые значения включают следующие.

Возвращаемый код/значение Описание
S_OK
 Путь успешно добавлен.
S_FALSE
 Путь доступа был успешно добавлен, однако произошла ошибка. Возможно, VDS не удалось обновить атрибут GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER секции или не удалось добавить сетевую папку по умолчанию (например, F$) при добавлении буквы диска. Дополнительные сведения см. в разделе PARTITION_INFORMATION_GPT.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 Сбой тома.
VDS_E_PACK_OFFLINE
0x80042444L
 Пакет, содержащий том, недоступен.

Комментарии

VDS добавляет путь доступа, создавая подключенную папку (также называемую точкой подключения тома). Обратите внимание, что подключенные папки поддерживаются только на томах NTFS. Дополнительные сведения см. в разделе Подключенные папки.

Этот метод возвращает ERROR_DIR_NOT_EMPTY, если параметр pwszPath содержит путь к подключенной папке, которая уже используется (даже если каталог пуст), или если pwszPath содержит путь к каталогу nonempty.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header vds.h
Библиотека Uuid.lib

См. также раздел

IVdsVolumeMF

SetVolumeMountPoint