Метод IVdsVolume::D elete (vds.h)
[Начиная с Windows 8 и Windows Server 2012, COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]
Удаляет том и все сплетения, освобождая экстенты.
Синтаксис
HRESULT Delete(
[in] BOOL bForce
);
Параметры
[in] bForce
Если значение РАВНО TRUE, VDS удаляет том, даже если он используется; В противном случае том не удаляется, если он используется.
Возвращаемое значение
Этот метод может возвращать стандартные значения HRESULT, такие как E_INVALIDARG или E_OUTOFMEMORY, а также возвращаемые значения VDS. Он также может возвращать коды преобразованных системных ошибок с помощью макроса HRESULT_FROM_WIN32 . Ошибки могут возникать из самого VDS или из используемого базового поставщика VDS . Возможные возвращаемые значения включают следующие.
Код возврата | Описание |
---|---|
|
Сплетения успешно удалены. |
Комментарии
Удалить тома можно только из интернет-пакета. Используйте метод IVdsPack::GetProperties , чтобы убедиться, что состояние пакета VDS_PS_ONLINE.
Невозможно удалить том, который находится на съемном носителе.
VDS отключает файловую систему перед удалением тома— операция, необходимая для FAT и FAT32, но не NTFS. Кроме того, VDS удаляет все пути доступа к тому после удаления самого тома. Если операция отключения завершается сбоем и bForce имеет значение true, VDS удаляет том без отключения. Клиентские приложения файловой системы должны обрабатывать эту ситуацию. Если отключение завершается успешно и операция удаления завершается сбоем, VDS пытается повторно подключить том.
VDS предотвращает удаление текущей системы и загрузочных томов, а также файлов подкачки, аварийных томов и томов гибернации. Вы можете переместить или сбросить аварийное завершение работы и файл подкачки. Том гибернации должен оставаться в загрузочном разделе.
Windows Server 2003: Аварийные тома и тома гибернации должны оставаться в загрузочном разделе.
Windows Server 2003: После удаления тома VDS пытается удалить подключенные папки. В случае сбоя удаление вернет VDS_S_ACCESS_PATH_NOT_DELETED, даже если том был успешно удален.
Требования
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Целевая платформа | Windows |
Header | vds.h |
Библиотека | Uuid.lib |