ISocialSession2::FollowPersonEx
Adiciona a pessoa identificada pelos parâmetros emailAddresses e displayName como um amigo para o usuário conectado na rede social.
HRESULT _stdcall FollowPersonEx([in] SAFEARRAY(BSTR) emailAddresses, [in] BSTR displayName);
Parâmetros
emailAddresses
[in] Uma matriz que contém um ou vários endereços SMTP válidos para uma pessoa na rede social.
displayName
[in] Uma cadeia de caracteres que contém o nome de exibição da pessoa a ser adicionada como um amigo.
Comentários
Se o OSC (Outlook Social Connector) fornecer mais do que o endereço SMTP na matriz no parâmetro emailAddresses , o provedor de OSC poderá assumir que o primeiro elemento é o endereço SMTP primário.
Se o provedor tiver definido o elemento followPerson como true nos recursos XML e nenhum dos elementos para emailAddresses corresponder a um usuário na rede, o provedor deverá retornar o erro OSC_E_NOT_FOUND. Se o provedor tiver definido followPerson como false em recursos, o provedor deverá retornar o erro OSC_E_FAIL.
Se o método FollowPersonEx for bem-sucedido, o provedor poderá usar a cadeia de caracteres no parâmetro displayName para abordar a pessoa em qualquer email de confirmação de amigo subsequente, em vez de abordar a pessoa pelo endereço SMTP. Por outro lado, o provedor deve ser capaz de manipular o OSC passando uma cadeia de caracteres vazia para o parâmetro displayName .
Se o provedor implementar a interface ISocialSession2 e tiver definido followPerson como true nos recursos XML, o OSC chamará FollowPersonEx em vez de ISocialSession::FollowPerson. Se o provedor tiver definido followPerson como true , mas não implementar a interface ISocialSession2 ou FollowPersonEx retornar o erro OSC_E_NOTIMPL, o OSC chamará ISocialSession::FollowPerson.