ISocialPerson::GetFriendsAndColleagues
Возвращает строку, представляющую коллекцию людей.
HRESULT _stdcall GetFriendsAndColleagues([out, retval] BSTR* personsCollection);
Параметры
personsCollection
[out] Строка XML, представляющая набор друзей пользователя и соответствующая определению друзей , как определено в схеме XML для расширения поставщика Outlook Social Connector (OSC).
Замечания
OSC вызывает GetFriendsAndColleagues, если поставщик OSC поддерживает кэшированную или гибридную синхронизацию друзей в социальной сети. Когда OSC первоначально вызывает метод GetFriendsAndColleagues для пользователя Outlook, вошедшего в социальную сеть, GetFriendsAndColleagues возвращает СТРОКУ XML, представляющую друзей пользователя, вошедшего в систему в социальной сети. Xml-строка соответствует определению схемы XML friends и указывает элемент person (который также соответствует определению схемы поставщика OSC) для каждого друга.
Когда GetFriendsAndColleagues возвращает сведения о друзьях для вошедшего пользователя, OSC сохраняет эти сведения в папке контактов. Эта папка связана с социальной сетью и находится в хранилище Outlook по умолчанию вошедшего пользователя. Дополнительные сведения о том, как OSC кэширует сведения о друзьях в папке контактов, см. в разделе Синхронизация друзей и действий.
Сведения для каждого друга, возвращенные в параметре personsCollection , соответствуют определению схемы XML для пользователя. Элемент person поддерживает множество сведений для каждого друга, в том числе SMTP-адреса электронной почты (которые сопоставляются с элементами emailAddress, emailAddress2 и emailAddress3 ), которые друг указал в социальной сети, и идентификатор пользователя (который сопоставляется с элементом userID ), который идентифицирует этого друга в социальной сети.
Чтобы отобразить действия для пользователя Outlook, выбранного в области Люди, OSC пытается сопоставить пользователя с каждым другом, возвращенным из GetFriendsAndColleagues. OsC делает это, сопоставляя SMTP-адрес выбранного пользователя Outlook с адресами электронной почты, указанными каждым другом в социальной сети. Если OSC находит соответствующий SMTP-адрес электронной почты, OSC использует соответствующий идентификатор пользователя друга для вызова метода ISocialSession::GetPerson . Это делается для получения объекта ISocialPerson для этого друга, который затем позволяет OSC получать действия и фотографии этого друга из социальной сети.
Однако если выбранный пользователь Outlook не указывает тот же SMTP-адрес в учетной записи в социальной сети или если у пользователя Outlook нет учетной записи в этой социальной сети, OSC не сможет найти совпадение для этого пользователя и не будет отображать никаких действий для этого пользователя в социальной сети.