ISocialPerson::GetFriendsAndColleagues
获取表示人员集合的字符串。
HRESULT _stdcall GetFriendsAndColleagues([out, retval] BSTR* personsCollection);
参数
personCollection
[out]一个 XML 字符串，表示一组好友，符合 Outlook Social Connector 的 XML 架构中定义的 好友 定义， (OSC) 提供程序扩展性。
备注
如果 OSC 提供程序支持社交网络上好友的缓存或混合同步，则 OSC 会调用 GetFriendsAndColleagues 。 当 OSC 最初为登录到社交网络的 Outlook 用户调用 GetFriendsAndColleagues 方法时， GetFriendsAndColleagues 将返回一个 XML 字符串，该字符串表示社交网络上登录用户的好友。 XML 字符串符合 友元 XML 架构定义，并指定 一个 person 元素 (该元素也符合每个友元的 OSC 提供程序架构定义) 。
当 GetFriendsAndColleagues 返回登录用户的好友信息时，OSC 会将该信息存储在联系人文件夹中。 此文件夹特定于社交网络，位于登录用户的默认 Outlook 存储中。 有关 OSC 如何在联系人文件夹中缓存好友信息的详细信息，请参阅 同步好友和活动。
personCollection 参数中返回的每个友元的信息符合 person 的 XML 架构定义。 person 元素支持每个好友的许多信息，包括映射到好友 (在社交网络上指定的 emailAddress、emailAddress2 和 emailAddress3 元素) 的 SMTP 电子邮件地址 (映射到在社交网络上标识该好友的 userID 元素) 的用户 ID。
若要显示在人员窗格中选择的 Outlook 用户的活动，OSC 会尝试将该用户与从 GetFriendsAndColleagues 返回的每个好友进行匹配。 OSC 通过将所选 Outlook 用户的 SMTP 地址与每个好友在社交网络上指定的电子邮件地址进行匹配来执行此操作。 如果 OSC 找到匹配的 SMTP 电子邮件地址，则 OSC 将使用友元的相应 userID 调用 ISocialSession：：GetPerson 方法。 这样做是为了获取该好友的 ISocialPerson 对象，然后使 OSC 能够从社交网络获取该好友的活动和图片。
但是，如果所选 Outlook 用户未在社交网络上的帐户上指定相同的 SMTP 地址，或者 Outlook 用户在该社交网络上没有帐户，则 OSC 将无法找到该用户的匹配项，并且不会在社交网络上显示该用户的任何活动。