Метод IVdsVolume::D elete (vds.h)

Статья
03/08/2023

[Начиная с 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	Сплетения успешно удалены.

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

Share via