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 如何使用和更新内存中此信息的详细信息,请参阅 同步好友和活动。