ISocialPerson::GetFriendsAndColleagues
Obtém uma cadeia de caracteres que representa uma coleção de pessoas.
HRESULT _stdcall GetFriendsAndColleagues([out, retval] BSTR* personsCollection);
Parâmetros
personsCollection
[out] Uma cadeia de caracteres XML que representa um conjunto de amigos da pessoa e que está em conformidade com a definição de amigos conforme definido no esquema XML para extensibilidade do provedor do OSC (Outlook Social Connector).
Comentários
O OSC chamará GetFriendsAndColleagues se o provedor OSC der suporte à sincronização híbrida ou em cache de amigos na rede social. Quando o OSC chama inicialmente o método GetFriendsAndColleagues para o usuário do Outlook que está conectado à rede social, GetFriendsAndColleagues retorna uma cadeia de caracteres XML que representa amigos do usuário conectado na rede social. A cadeia de caracteres XML está em conformidade com a definição de esquema XML de amigos e especifica um elemento de pessoa (que também está em conformidade com a definição de esquema do provedor osC) para cada amigo.
Quando GetFriendsAndColleagues retorna as informações de amigos para o usuário conectado, o OSC armazena essas informações em uma pasta de contatos. Essa pasta é específica para a rede social e reside no repositório padrão do outlook do usuário conectado. Para obter mais informações sobre como o OSC armazena em cache as informações dos amigos em uma pasta de contatos, confira Sincronizando Amigos e Atividades.
As informações de cada amigo retornado no parâmetro personsCollection estão em conformidade com a definição de esquema XML para pessoa. O elemento pessoa dá suporte a muitas informações para cada amigo, incluindo os endereços de email SMTP (que mapeiam para os elementos emailAddress, emailAddress2 e emailAddress3 ) que o amigo especificou na rede social e a ID do usuário (que mapeia para o elemento userID ) que identifica esse amigo na rede social.
Para mostrar atividades para um usuário do Outlook selecionado no painel Pessoas, o OSC tenta corresponder o usuário com cada amigo retornado de GetFriendsAndColleagues. O OSC faz isso correspondendo ao endereço SMTP do usuário selecionado do Outlook com os endereços de email especificados por cada amigo na rede social. Se o OSC encontrar um endereço de email SMTP correspondente, o OSC usará o userID correspondente do amigo para chamar o método ISocialSession::GetPerson . Ele faz isso para obter um objeto ISocialPerson para esse amigo, o que permite que o OSC obtenha atividades e fotos desse amigo da rede social.
No entanto, se o usuário selecionado do Outlook não especificar o mesmo endereço SMTP em uma conta na rede social ou se o usuário do Outlook não tiver uma conta nessa rede social, o OSC não poderá encontrar uma correspondência para esse usuário e não exibirá nenhuma atividade para esse usuário na rede social.