ISocialPerson::GetFriendsAndColleagues
Obtient une chaîne qui représente une collection de personnes.
HRESULT _stdcall GetFriendsAndColleagues([out, retval] BSTR* personsCollection);
Paramètres
personsCollection
[out] Chaîne XML qui représente un ensemble d’amis de la personne et qui est conforme à la définition d’amis telle que définie dans le schéma XML pour l’extensibilité du fournisseur OSC (Outlook Social Connector).
Remarques
L’OSC appelle GetFriendsAndColleagues si le fournisseur OSC prend en charge la synchronisation en cache ou hybride des amis sur le réseau social. Lorsque l’OSC appelle initialement la méthode GetFriendsAndColleagues pour l’utilisateur Outlook connecté au réseau social, GetFriendsAndColleagues renvoie une chaîne XML qui représente les amis de l’utilisateur connecté sur le réseau social. La chaîne XML est conforme à la définition de schéma XML friends et spécifie un élément person (qui est également conforme à la définition de schéma du fournisseur OSC) pour chaque ami.
Lorsque GetFriendsAndColleagues retourne les informations d’amis de l’utilisateur connecté, l’OSC stocke ces informations dans un dossier contacts. Ce dossier est spécifique au réseau social et se trouve dans le magasin Outlook par défaut de l’utilisateur connecté. Pour plus d’informations sur la façon dont l’OSC met en cache les informations des amis dans un dossier contacts, consultez Synchronisation des amis et des activités.
Les informations pour chaque ami retournées dans le paramètre personsCollection sont conformes à la définition de schéma XML pour person. L’élément person prend en charge de nombreuses informations pour chaque ami, notamment les adresses e-mail SMTP (qui correspondent aux éléments emailAddress, emailAddress2 et emailAddress3 ) que l’ami a spécifiées sur le réseau social, et l’ID utilisateur (qui correspond à l’élément userID ) qui identifie cet ami sur le réseau social.
Pour afficher les activités d’un utilisateur Outlook sélectionné dans le volet Personnes, le OSC tente de faire correspondre l’utilisateur à chaque ami renvoyé par GetFriendsAndColleagues. Pour ce faire, l’OSC fait correspondre l’adresse SMTP de l’utilisateur Outlook sélectionné avec les adresses e-mail que chaque ami a spécifiées sur le réseau social. Si l’OSC trouve une adresse e-mail SMTP correspondante, l’OSC utilise l’id utilisateur correspondant de l’ami pour appeler la méthode ISocialSession ::GetPerson . Il le fait pour obtenir un objet ISocialPerson pour cet ami, ce qui permet ensuite à la CVMO d’obtenir des activités et des photos de cet ami à partir du réseau social.
Toutefois, si l’utilisateur Outlook sélectionné ne spécifie pas cette même adresse SMTP sur un compte sur le réseau social, ou si l’utilisateur Outlook n’a pas de compte sur ce réseau social, l’OSC ne pourra pas trouver de correspondance pour cet utilisateur et n’affichera aucune activité pour cet utilisateur sur le réseau social.