IDiaPropertyStorage::ReadMultiple
从当前属性集中读取指定的属性。
语法
HRESULT ReadMultiple(
ULONG cpspec,
PROPSPEC const rgpspec,
PROPVARIANT rgvar
);
参数
cpspec
[in] rgpspec
数组中指定属性的计数。 如果为零,则该方法不返回任何属性,但会返回 S_OK
作为成功代码。
rgpspec
[in] 要读取的属性的数组。 可以通过属性 ID 或可选的字符串名称指定属性。 不需要在数组中按任何特定顺序指定属性。 数组可以包含重复的属性,导致简单属性返回时出现重复的属性值。 非简单属性在尝试再次打开它们时应返回拒绝访问。 数组可以包含属性 ID 和字符串 ID 的组合。 此数组必须具有至少 cpspec
个属性值。
rgvar
[in, out] 要填充每个属性的值的 PROPVARIANT
结构数组(在 Microsoft.VisualStudio.OLE.Interop 命名空间中)。 该数组的大小必须至少为个 cpspec
元素。 调用方不需要初始化数组中的值。
返回值
如果成功,则返回 S_OK
。 如果未找到一个或多个属性,则返回 S_FALSE
。 否则,返回错误代码。
备注
如果未找到属性,则 rgvar
数组中的相应条目包含类型为 VT_EMPTY
的 VARIANT
。