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


Метод IVdsIscsiTarget::D elete (vdshwprv.h)

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

Удаляет целевой объект и все его группы портала, если с целевым объектом не связаны LUN.

Синтаксис

HRESULT Delete(
  [out] IVdsAsync **ppAsync
);

Параметры

[out] ppAsync

Адрес указателя интерфейса IVdsAsync , который ИНИЦиализирует VDS при возврате. Вызывающие элементы должны освободить интерфейс. Используйте этот интерфейс для отмены, ожидания или запроса состояния операции. При вызове метода IVdsAsync::Wait в этом интерфейсе и возвращается значение HRESULT успешно, необходимо освободить интерфейсы, возвращаемые в структуре VDS_ASYNC_OUTPUT , вызвав метод IUnknown::Release для каждого указателя интерфейса. Однако если ожидание возвращает значение HRESULT сбоя или если параметр pHrResult в Wait получает значение HRESULT сбоя, указатели интерфейса в структуре VDS_ASYNC_OUTPUT имеют значение NULL и не нужно выпускать. Вы можете протестировать значения HRESULT успешно или неудачно, используя макросы SUCCESSED и FAILED , определенные в Winerror.h.

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

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

Возврат кода или значения Description
S_OK
Группа портала была успешно создана.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
Кэш поставщика поврежден. Это означает проблему программного обеспечения или связи внутри поставщика, который кэширует сведения о подключенных устройствах. Вызывающий объект может использовать метод IVdsHwProvider::Reenumerate , за которым следует метод IVdsHwProvider::Refresh для восстановления кэша.
VDS_E_OBJECT_DELETED
0x8004240BL
Целевой объект больше не присутствует.
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
Другая операция выполняется; Эта операция не может продолжаться до завершения предыдущих операций.
VDS_E_ASSOCIATED_LUNS_EXIST
0x8004270BL
LUN связаны с этим целевым объектом. Все LUN должны быть отсоединены от этого целевого объекта, прежде чем этот целевой объект можно удалить.

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows Vista [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 R2 [только классические приложения]
целевая платформа Виндоус
Header vdshwprv.h
Library Uuid.lib
Распространяемый VDS 1.1

См. также

IVdsAsync

IVdsIscsiTarget