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


Метод IVdsService::QueryProviders (vds.h)

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

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

Синтаксис

HRESULT QueryProviders(
  [in]  DWORD          masks,
  [out] IEnumVdsObject **ppEnum
);

Параметры

[in] masks

Маска поставщика, перечисленная VDS_QUERY_PROVIDER_FLAG. Вызывающие абоненты могут указать маску поставщика программного обеспечения, маску поставщика оборудования или и то, и другое.

[out] ppEnum

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

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

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

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

Комментарии

Чтобы определить тип поставщика для поставщиков оборудования, вызовите метод IVdsHwProviderType2::GetProviderType2 или метод IVdsHwProviderType::GetProviderType для каждого объекта поставщика.

Требования

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

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

IEnumVdsObject

IVdsService

VDS_HWPROVIDER_TYPE

VDS_QUERY_PROVIDER_FLAG