ISocialSession2::GetPeopleDetails
Retorna uma cadeia de caracteres que contém uma coleção de detalhes de pessoa e imagem para os usuários especificados pelo parâmetro personsAddresses .
HRESULT _stdcall GetPeopleDetails([in] BSTR personsAddresses, [out, retval] BSTR* personsCollection);
Parâmetros
personsAddresses
[in] Uma cadeia de caracteres XML que especifica os endereços SMTP hashed de um conjunto de usuários.
personsCollection
[out] Uma cadeia de caracteres XML que contém uma coleção de detalhes de pessoa e imagem.
Comentários
O OSC (Outlook Social Connector) chamará GetPeopleDetails se o provedor OSC der suporte à sincronização sob demanda ou híbrida de amigos e não amigos.
O parâmetro personsAddresses deve estar em conformidade com a definição de esquema para hashedAddresses, conforme definido no esquema para extensibilidade do provedor OSC. A cadeia de caracteres personsAddresses representa um conjunto de endereços SMTP hashed para cada usuário exibido no painel Pessoas. O usuário não precisa ser amigo do usuário conectado representado pela propriedade ISocialSession::LoggedOnUserName . Os endereços SMTP hashed são criptografados usando a função de hash especificada pelo elemento hashFunction nos recursos do provedor XML. O OSC identifica cada hashedAddress na coleção personAddresses com um elemento index . O provedor deve usar o elemento index para identificar o XML da pessoa do destinatário quando ele retorna xML de amigos para GetPeopleDetails. Se o destinatário não for um usuário registrado na rede social, o provedor não deverá retornar nenhuma pessoa XML para esse destinatário. O elemento index para cada usuário de rede representado por XML de pessoa corresponde ao elemento index para o destinatário em personsAddresses.
O OSC armazena as informações retornadas pelo parâmetro personsCollection na memória. A cadeia de caracteres XML personsCollection deve estar em conformidade com a definição de esquema para amigos, conforme definido no esquema de extensibilidade do provedor OSC. Para obter mais informações sobre como o OSC usa e atualiza essas informações na memória, confira Sincronizando Amigos e Atividades.