IVdsService::QueryProviders 方法 (vds.h)

[从 Windows 8 和 Windows Server 2012 开始,虚拟磁盘服务 COM 接口由 Windows 存储管理 API 取代。]

返回一个枚举对象,其中包含 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
标头 vds.h
Library Uuid.lib

另请参阅

IEnumVdsObject

IVdsService

VDS_HWPROVIDER_TYPE

VDS_QUERY_PROVIDER_FLAG