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

Метод IVdsLunIscsi::QueryAssociatedTargets (vds.h)

  • Статья

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

Возвращает перечисление связанных в настоящее время целевых объектов iSCSI — целевых объектов, через которые доступен LUN.

Синтаксис

HRESULT QueryAssociatedTargets(
  [out] IEnumVdsObject **ppEnum
);

Параметры

[out] ppEnum

Адрес указателя интерфейса IEnumVdsObject , который можно использовать для перечисления целевых объектов iSCSI в качестве целевых объектов. Дополнительные сведения см. в статье Работа с объектами перечисления. Вызывающие объекты должны освободить интерфейс и каждый из целевых объектов, если они больше не нужны, вызвав метод IUnknown::Release .

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

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

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

Комментарии

Большинство подсистем реализуют только один связанный целевой объект на LUN, но некоторые из них допускают несколько связанных целевых объектов.

Используйте метод IVdsLunIscsi::AssociateTargets , чтобы связать целевой объект. Используйте метод IVdsIscsiTarget::QueryAssociatedLuns для запроса LUN, связанных с целевым объектом.

Требования

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

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

IVdsLunIscsi

IVdsLunIscsi::AssociateTargets