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

Статья
03/08/2023

[Начиная с 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

Share via