Поделиться через


Метод 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 . Возможные возвращаемые значения включают следующие.

Код возврата Описание
S_OK
Сплетения успешно удалены.

Комментарии

Удалить тома можно только из интернет-пакета. Используйте метод 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

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

IVdsPack::GetProperties

IVdsVolume

VDS_PACK_STATUS