ISocialSession2::FollowPersonEx
Fügt die durch die Parameter emailAddresses und displayName identifizierte Person als Freund für den angemeldeten Benutzer im sozialen Netzwerk hinzu.
HRESULT _stdcall FollowPersonEx([in] SAFEARRAY(BSTR) emailAddresses, [in] BSTR displayName);
Parameter
emailAddresses
[in] Ein Array, das eine oder mehrere gültige SMTP-Adressen für eine Person im sozialen Netzwerk enthält.
displayName
[in] Eine Zeichenfolge, die den Anzeigenamen der Person enthält, die als Freund hinzugefügt werden soll.
Hinweise
Wenn der Outlook Connector für soziale Netzwerke (OSC) mehr als die SMTP-Adresse im Array im Parameter emailAddresses bereitstellt, kann der OSC-Anbieter davon ausgehen, dass das erste Element die primäre SMTP-Adresse ist.
Wenn der Anbieter das followPerson-Element in der Capabilities-XML auf true festgelegt hat und keines der Elemente für emailAddresses mit einem Benutzer im Netzwerk übereinstimmt, muss der Anbieter den OSC_E_NOT_FOUND Fehler zurückgeben. Wenn der Anbieter followPerson in den Funktionen auf false festgelegt hat, sollte der Anbieter den OSC_E_FAIL Fehler zurückgeben.
Wenn die FollowPersonEx-Methode erfolgreich ist, kann der Anbieter die Zeichenfolge im displayName-Parameter verwenden, um die Person in einer nachfolgenden Friend-Confirmation-E-Mail zu adressieren, anstatt die Person über die SMTP-Adresse zu adressieren. Andererseits muss der Anbieter in der Lage sein, den OSC zu verarbeiten, der eine leere Zeichenfolge für den displayName-Parameter übergibt.
Wenn der Anbieter die ISocialSession2-Schnittstelle implementiert und followPerson im Funktions-XML als true festgelegt hat, ruft osc FollowPersonEx anstelle von ISocialSession::FollowPerson auf. Wenn der Anbieter followPerson auf true festgelegt hat, aber die ISocialSession2-Schnittstelle nicht implementiert oder FollowPersonEx den OSC_E_NOTIMPL Fehler zurückgibt, ruft das OSC ISocialSession::FollowPerson auf.