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

  • Статья

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

Удаляет путь доступа из текущего тома.

Синтаксис

HRESULT DeleteAccessPath(
  [in] LPWSTR pwszPath,
  [in] BOOL   bForce
);

Параметры

[in] pwszPath

Строка, содержащая удаляемую схему доступа. Путь доступа может быть буквой диска или путем к пустому каталогу на томе NTFS. Если это буква диска, необходимо включить обратную косую черту в конце, например F:. Если это путь к каталогу, обратная косая черта в конце не требуется, например "C:\MyFolder\MyDocuments".

[in] bForce

Если задано значение TRUE, путь доступа удаляется безоговорочно, даже если используется том. Этот параметр имеет смысл, только если путь доступа представляет собой букву диска.

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

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

Возвращаемый код или значение Описание
S_OK
 Метод завершился успешно.
VDS_E_OPERATION_DENIED
0x8004240AL
 Путь ведет к системным томам, загрузочному тому, тому аварийного восстановления, тому гибернации или тому файла подкачки. Вы не можете удалить букву диска из этих томов.
VDS_E_PATH_NOT_FOUND
0x80042416L
 Указанный путь не найден.
VDS_E_DEVICE_IN_USE
0x80042413L
 Путь доступа был успешно удален, однако произошла ошибка. Возможно, VDS не удалось обновить атрибут таблицы разделов GUID (GPT) секции или не удалось удалить сетевую папку по умолчанию (например, F$) при удалении буквы диска.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 Сбой тома.
VDS_E_PACK_OFFLINE
0x80042444L
 Пакет, содержащий том, недоступен.

Комментарии

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

Требования

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

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

IVdsVolumeMF

IVdsVolumeMF::AddAccessPath

IVdsVolumeMF::QueryAccessPaths