IPropertyStorage::ReadMultiple 方法 (propidlbase.h)
ReadMultiple 方法从当前属性集中读取指定的属性。
语法
HRESULT ReadMultiple(
[in] ULONG cpspec,
[in] const PROPSPEC [] rgpspec,
[out] PROPVARIANT [] rgpropvar
);
参数
[in] cpspec
在 rgpspec 数组中要指定的属性的数值计数。 此参数的值可以设置为零;但是,这违背了 方法的用途,因为无论 rgpspec 中设置的值如何,都无需读取任何属性。
[in] rgpspec
PROPSPEC 结构的数组指定要读取的属性。 可以通过属性 ID 或可选的字符串名称指定属性。 不需要在数组中按任何特定顺序指定属性。 数组可以包含重复的属性,导致简单属性返回时出现重复的属性值。 尝试第二次打开非简单属性时,应返回拒绝的访问。 数组可以包含属性 ID 和字符串 ID 的组合。
[out] rgpropvar
PROPVARIANT 结构的调用方分配的数组,该结构在返回时包含由 rgpspec 数组中的相应元素指定的属性值。 数组必须至少足够大,以容纳 PROPVARIANT 结构的 cpspec 参数的值。 cpspec 参数指定数组中设置的属性数。 调用方不需要以任何特定顺序初始化这些 PROPVARIANT 结构值。 但是,实现必须在返回时正确填充所有成员。 如果没有其他适当的值,则实现必须将每个 PROPVARIANT 结构的 vt 成员设置为VT_EMPTY。
返回值
此方法支持 标准返回值E_UNEXPECTED以及以下值:
此函数还可以返回任何文件系统错误或包装在 HRESULT 数据类型中的 Win32 错误。 有关详细信息,请参阅 错误处理策略。
有关详细信息,请参阅 属性存储注意事项。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | propidlbase.h (包括 Objbase.h、Propidlbase.h) |
Library | Uuid.lib |
DLL | Ole32.dll |
另请参阅
IPropertyStorage::WriteMultiple