ISocialSession2::GetPeopleDetails

返回一个字符串,其中包含由 personAddresses 参数指定的用户的人员和图片详细信息集合。

HRESULT _stdcall GetPeopleDetails([in] BSTR personsAddresses, [out, retval] BSTR* personsCollection);

参数

personsAddresses

[in]一个 XML 字符串,指定一组用户的哈希 SMTP 地址。

personCollection

[out]包含人员详细信息和图片详细信息集合的 XML 字符串。

备注

如果 OSC 提供程序支持好友和非好友的按需或混合同步,则 Outlook 社交连接器 (OSC) 调用 GetPeopleDetails

personsAddresses 参数必须符合 hashedAddresses 的架构定义,如 OSC 提供程序扩展性架构中定义的那样。 personAddresses 字符串表示人员窗格中显示的每个用户的一组经过哈希处理的 SMTP 地址。 用户不必是 ISocialSession::LoggedOnUserName 属性所表示的登录用户的好友。 使用提供程序功能 XML 中的 hashFunction 元素指定的哈希函数对经过哈希处理的 SMTP 地址进行加密。 OSC 使用索引元素标识 personAddresses 集合中的每个 hashedAddress 当提供程序返回 GetPeopleDetails好友 XML 时,必须使用 index 元素来标识收件人的人员 XML。 如果收件人不是社交网络上的注册用户,则提供商不得为该收件人 返回任何人 XML由 person XML 表示的每个网络用户的 index 元素对应于 personAddresses 中收件人的索引元素。

OSC 将 personCollection 参数返回的信息存储在内存中。 personCollection XML 字符串必须符合友元的架构定义,如 OSC 提供程序扩展性架构中定义的那样。 有关 OSC 如何使用和更新内存中此信息的详细信息,请参阅 同步好友和活动

另请参阅