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 提供程序 。 可能的返回值包括以下内容。
返回代码/值 | 说明 |
---|---|
|
已成功返回枚举。 |
|
VDS 初始化失败。 如果应用程序在服务完成初始化之前调用此方法,则会阻止该方法,直到初始化完成。 如果初始化失败,则返回此错误。 |
注解
若要确定硬件提供程序的提供程序类型,请为每个提供程序对象调用 IVdsHwProviderType2::GetProviderType2 方法或 IVdsHwProviderType::GetProviderType 方法。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | vds.h |
Library | Uuid.lib |