Share via

Метод IVdsServiceHba::QueryHbaPorts (vds.h)

  • Статья

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

Возвращает объект перечисления IEnumVdsObject , содержащий список портов HBA, известных VDS в локальной системе.

Синтаксис

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

Параметры

[out] ppEnum

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

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

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

Возвращаемый код/значение Описание
S_OK
 Перечисление портов HBA было успешно возвращено. Если в локальной системе нет портов HBA, перечисление будет пустым.
VDS_E_INITIALIZED_FAILED
0x80042401L
 Не удалось инициализировать VDS. Если приложение вызывает этот метод до завершения инициализации службы VDS, метод блокируется до завершения инициализации. Если инициализация завершается сбоем, возвращается эта ошибка.

Требования

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

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

IEnumVdsObject

IVdsServiceHba