ISocialSession2::FollowPersonEx
Adds the person identified by the emailAddresses and displayName parameters as a friend for the logged-on user on the social network.
HRESULT _stdcall FollowPersonEx([in] SAFEARRAY(BSTR) emailAddresses, [in] BSTR displayName);
Parameters
emailAddresses
[in] An array that contains one or multiple valid SMTP addresses for a person on the social network.
displayName
[in] A string that contains the display name of the person to be added as a friend.
Remarks
If the Outlook Social Connector (OSC) provides more than on SMTP address in the array in the emailAddresses parameter, the OSC provider can assume the first element is the primary SMTP address.
If the provider has set the followPerson element as true in the capabilities XML, and none of the elements for emailAddresses match a user on the network, the provider must return the OSC_E_NOT_FOUND error. If the provider has set followPerson as false in capabilities, the provider should return the OSC_E_FAIL error.
If the FollowPersonEx method succeeds, the provider can use the string in the displayName parameter to address the person in any subsequent friend-confirmation email, rather than addressing the person by the SMTP address. On the other hand, the provider must be able to handle the OSC passing an empty string for the displayName parameter.
If the provider implements the ISocialSession2 interface and has set followPerson as true in the capabilities XML, the OSC calls FollowPersonEx instead of ISocialSession::FollowPerson. If the provider has set followPerson as true but does not implement the ISocialSession2 interface, or FollowPersonEx returns the OSC_E_NOTIMPL error, the OSC calls ISocialSession::FollowPerson.