IPropertyStoreFactory::GetPropertyStoreForKeys 方法 (propsys.h)
获取给定一组属性键的 IPropertyStore 对象。 与调用 IPropertyStoreFactory::GetPropertyStore 相比,这提供了一种可能更快获取 IPropertyStore 对象的替代方法。
语法
HRESULT GetPropertyStoreForKeys(
[in] const PROPERTYKEY *rgKeys,
[in] UINT cKeys,
[in] GETPROPERTYSTOREFLAGS flags,
[in] REFIID riid,
[out] void **ppv
);
参数
[in] rgKeys
类型: const PROPERTYKEY*
指向 PROPERTYKEY 结构数组的指针。
[in] cKeys
类型: UINT
rgKeys 指向的数组中的 PROPERTYKEY 结构数。
[in] flags
修改返回的存储的 GETPROPERTYSTOREFLAGS 值。
[in] riid
类型: REFIID
对要创建的对象的 IID 的引用。
[out] ppv
类型: void**
此方法返回时,包含 IPropertyStore 接口指针的地址。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
建议使用 Objbase.h 中定义的 IID_PPV_ARGS 宏打包 riid 和 ppv 参数。 此宏基于 ppv 中的 值指向的接口提供正确的 IID,这消除了编码错误的可能性。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | propsys.h |