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

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

Удаляет одно или несколько указанных сплетений из текущего тома, освобождая экстенты.

Синтаксис

HRESULT RemovePlex(
  [in]  VDS_OBJECT_ID plexId,
  [out] IVdsAsync     **ppAsync
);

Параметры

[in] plexId

GUID удаляемого плекса.

[out] ppAsync

Адрес указателя интерфейса IVdsAsync , который VDS инициализирует при возврате. Вызывающие элементы должны освободить интерфейс. Используйте этот указатель для отмены, ожидания или запроса состояния операции.

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

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

Возвращаемый код или значение Описание
S_OK
Сплетение успешно удалено.
VDS_E_VOLUME_NOT_ONLINE
0x8004243DL
Том недоступен.
VDS_E_VOLUME_NOT_A_MIRROR
0x80042445L
Том не является зеркало.

Комментарии

Эта операция не может удалить последний сплетение тома. Вместо этого используйте метод IVdsVolume::D elete , чтобы удалить последний оставшийся том (единственный сплекс). Этот метод недопустим для базовых томов, которые имеют ровно один плекс.

VDS не отключает том при удалении сплетения.

Реализующие объекты должны возвращать указатель на интерфейс IVdsAsync для этого метода независимо от того, инициирует ли вызов асинхронную операцию.

Требования

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

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

IVdsAsync

IVdsVolume

IVdsVolume::D elete