ISocialSession2::GetPeopleDetails
Returns a string that contains a collection of person and picture details for the users specified by the personsAddresses parameter.
HRESULT _stdcall GetPeopleDetails([in] BSTR personsAddresses, [out, retval] BSTR* personsCollection);
Parameters
personsAddresses
[in] An XML string that specifies the hashed SMTP addresses of a set of users.
personsCollection
[out] An XML string that contains a collection of person and picture details.
Remarks
The Outlook Social Connector (OSC) calls GetPeopleDetails if the OSC provider supports on-demand or hybrid synchronization of friends and non-friends.
The personsAddresses parameter must conform to the schema definition for hashedAddresses, as defined in the schema for OSC provider extensibility. The personsAddresses string represents a set of hashed SMTP addresses for each user displayed in the People Pane. The user does not have to be a friend of the logged-on user represented by the ISocialSession::LoggedOnUserName property. The hashed SMTP addresses are encrypted by using the hashing function specified by the hashFunction element in the provider's capabilities XML. The OSC identifies each hashedAddress in the personAddresses collection with an index element. The provider must use the index element to identify the recipient's person XML when it returns friends XML for GetPeopleDetails. If the recipient is not a registered user on the social network, the provider must not return any person XML for that recipient. The index element for each network user represented by person XML corresponds to the index element for the recipient in personsAddresses.
The OSC stores the information returned by the personsCollection parameter in memory. The personsCollection XML string must conform to the schema definition for friends, as defined in the schema for OSC provider extensibility. For more information about how the OSC uses and updates this information in memory, see Synchronizing Friends and Activities.