ISocialSession2::GetPeopleDetails
Renvoie une chaîne qui contient une collection de détails de personne et d’image pour les utilisateurs spécifiés par le paramètre personsAddresses .
HRESULT _stdcall GetPeopleDetails([in] BSTR personsAddresses, [out, retval] BSTR* personsCollection);
Paramètres
personsAddresses
[in] Chaîne XML qui spécifie les adresses SMTP hachées d’un ensemble d’utilisateurs.
personsCollection
[out] Chaîne XML qui contient une collection de détails de personne et d’image.
Remarques
Outlook Social Connector (OSC) appelle GetPeopleDetails si le fournisseur OSC prend en charge la synchronisation à la demande ou hybride d’amis et de non-amis.
Le paramètre personsAddresses doit être conforme à la définition de schéma pour hashedAddresses, comme défini dans le schéma pour l’extensibilité du fournisseur OSC. La chaîne personsAddresses représente un ensemble d’adresses SMTP hachées pour chaque utilisateur affiché dans le volet Personnes. L’utilisateur n’a pas besoin d’être un ami de l’utilisateur connecté représenté par la propriété ISocialSession ::LoggedOnUserName . Les adresses SMTP hachées sont chiffrées à l’aide de la fonction de hachage spécifiée par l’élément hashFunction dans le code XML des fonctionnalités du fournisseur. L’OSC identifie chaque hashedAddress dans la collection personAddresses avec un élément index . Le fournisseur doit utiliser l’élément index pour identifier le code XML de la personne du destinataire lorsqu’il retourne le code XML des amis pour GetPeopleDetails. Si le destinataire n’est pas un utilisateur inscrit sur le réseau social, le fournisseur ne doit pas retourner le code XML de personne pour ce destinataire. L’élément index pour chaque utilisateur réseau représenté par le code XML de personne correspond à l’élément index du destinataire dans personsAddresses.
L’OSC stocke les informations retournées par le paramètre personsCollection en mémoire. La chaîne XML personsCollection doit être conforme à la définition de schéma pour les amis, comme défini dans le schéma pour l’extensibilité du fournisseur OSC. Pour plus d’informations sur la façon dont l’OSC utilise et met à jour ces informations en mémoire, consultez Synchronisation des amis et des activités.