Поделиться через


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.

См. также