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_EMPTYVARIANT

另请参阅