ISocialPerson::GetFriendsAndColleagues
Obtiene una cadena que representa una colección de personas.
HRESULT _stdcall GetFriendsAndColleagues([out, retval] BSTR* personsCollection);
Parameters
personsCollection
[out] Cadena XML que representa un conjunto de amigos de la persona y que cumple con la definición de amigos tal como se define en el esquema XML para la extensibilidad del proveedor de Outlook Social Connector (OSC).
Comentarios
El OSC llama a GetFriendsAndColleagues si el proveedor de OSC admite la sincronización híbrida o en caché de amigos en la red social. Cuando el OSC llama inicialmente al método GetFriendsAndColleagues para el usuario de Outlook que ha iniciado sesión en la red social, GetFriendsAndColleagues devuelve una cadena XML que representa a los amigos del usuario que ha iniciado sesión en la red social. La cadena XML cumple con la definición de esquema XML de amigos y especifica un elemento person (que también cumple con la definición de esquema del proveedor de OSC) para cada amigo.
Cuando GetFriendsAndColleagues devuelve la información de amigos del usuario que ha iniciado sesión, el OSC almacena esa información en una carpeta de contactos. Esta carpeta es específica de la red social y reside en el almacén de Outlook predeterminado del usuario que ha iniciado sesión. Para obtener más información sobre cómo el OSC almacena en caché la información de los amigos en una carpeta de contactos, consulte Sincronización de amigos y actividades.
La información de cada amigo devuelto en el parámetro personsCollection cumple con la definición de esquema XML para persona. El elemento person admite muchos fragmentos de información para cada amigo, incluidas las direcciones de correo electrónico SMTP (que se asignan a los elementos emailAddress, emailAddress2 y emailAddress3 ) que el amigo ha especificado en la red social y el identificador de usuario (que se asigna al elemento userID ) que identifica a ese amigo en la red social.
Para mostrar las actividades de un usuario de Outlook seleccionado en el panel de Personas, el OSC intenta hacer coincidir al usuario con cada amigo devuelto por GetFriendsAndColleagues. El OSC hace esto haciendo coincidir la dirección SMTP del usuario de Outlook seleccionado con las direcciones de correo electrónico que cada amigo ha especificado en la red social. Si el OSC encuentra una dirección de correo electrónico SMTP coincidente, el OSC usa el id. de usuario correspondiente del amigo para llamar al método ISocialSession::GetPerson . Lo hace para obtener un objeto ISocialPerson para ese amigo, lo que permite al OSC obtener actividades e imágenes de ese amigo de la red social.
Sin embargo, si el usuario de Outlook seleccionado no especifica esa misma dirección SMTP en una cuenta de la red social, o si el usuario de Outlook no tiene una cuenta en esa red social, el OSC no podrá encontrar una coincidencia para ese usuario y no mostrará ninguna actividad para ese usuario en la red social.