ISocialSession2::FollowPersonEx
Добавляет пользователя, определенного параметрами emailAddresses и displayName , в качестве друга для вошедшего пользователя в социальную сеть.
HRESULT _stdcall FollowPersonEx([in] SAFEARRAY(BSTR) emailAddresses, [in] BSTR displayName);
Параметры
emailAddresses
[в] Массив, содержащий один или несколько допустимых SMTP-адресов для пользователя в социальной сети.
displayName
[в] Строка, содержащая отображаемое имя пользователя, добавляемого в качестве друга.
Замечания
Если outlook Social Connector (OSC) предоставляет больше smtp-адреса в массиве в параметре emailAddresses , поставщик OSC может предположить, что первый элемент является основным SMTP-адресом.
Если поставщик задал элемент followPerson как true в XML-коде возможностей и ни один из элементов для emailAddresses не соответствует пользователю в сети, поставщик должен вернуть ошибку OSC_E_NOT_FOUND. Если поставщик установил параметр followPerson как false в возможностях, поставщик должен вернуть ошибку OSC_E_FAIL.
Если метод FollowPersonEx успешно выполнен, поставщик может использовать строку в параметре displayName , чтобы обратиться к пользователю в любом последующем сообщении электронной почты с подтверждением друга, а не обращаться к пользователю по SMTP-адресу. С другой стороны, поставщик должен иметь возможность обработать OSC, передав пустую строку для параметра displayName .
Если поставщик реализует интерфейс ISocialSession2 и задает параметр followPerson как true в XML-коде возможностей, ТО OSC вызывает FollowPersonEx вместо ISocialSession::FollowPerson. Если поставщик присвоил параметру followPersonзначение true , но не реализует интерфейс ISocialSession2 или followPersonEx возвращает ошибку OSC_E_NOTIMPL, OSC вызывает ISocialSession::FollowPerson.