ISocialSession2::FollowPersonEx
将 emailAddresses 和 displayName 参数标识的人员添加为社交网络上登录用户的好友。
HRESULT _stdcall FollowPersonEx([in] SAFEARRAY(BSTR) emailAddresses, [in] BSTR displayName);
参数
emailAddresses
[in]一个数组,其中包含社交网络上人员的一个或多个有效 SMTP 地址。
displayName
[in]一个字符串,包含要添加为好友的人员的显示名称。
备注
如果 Outlook Social Connector (OSC) 在 emailAddresses 参数数组中的 SMTP 地址上提供了更多,则 OSC 提供程序可以假定第一个元素是主 SMTP 地址。
如果提供程序在功能 XML 中将 followPerson 元素设置为 true,并且 emailAddresses 的任何元素都与网络上的用户匹配,则提供程序必须返回OSC_E_NOT_FOUND错误。 如果提供程序在功能中将 followPerson 设置为 false,则提供程序应返回OSC_E_FAIL错误。
如果 FollowPersonEx 方法成功,提供程序可以使用 displayName 参数中的字符串在任何后续的好友确认电子邮件中向该人员寻址,而不是通过 SMTP 地址向该人员寻址。 另一方面,提供程序必须能够处理为 displayName 参数传递空字符串的 OSC。
如果提供程序实现 ISocialSession2 接口并在功能 XML 中将 followPerson 设置为 true ,则 OSC 将调用 FollowPersonEx 而不是 ISocialSession::FollowPerson。 如果提供程序已将 followPerson 设置为 true ,但未实现 ISocialSession2 接口,或者 FollowPersonEx 返回OSC_E_NOTIMPL错误,则 OSC 将调用 ISocialSession::FollowPerson。