ISocialPerson::GetFriendsAndColleagues
Ruft eine Zeichenfolge ab, die eine Auflistung von Personen darstellt.
HRESULT _stdcall GetFriendsAndColleagues([out, retval] BSTR* personsCollection);
Parameter
personsCollection
[out] Eine XML-Zeichenfolge, die eine Gruppe von Freunden der Person darstellt und der Definition von Freunden entspricht, die im XML-Schema für die Erweiterbarkeit des Outlook-Connectors für soziale Netzwerke (OSC) definiert ist.
Hinweise
Der OSC ruft GetFriendsAndColleagues auf, wenn der OSC-Anbieter die zwischengespeicherte oder hybride Synchronisierung von Freunden im sozialen Netzwerk unterstützt. Wenn das OSC zunächst die GetFriendsAndColleagues-Methode für den Outlook-Benutzer aufruft, der beim sozialen Netzwerk angemeldet ist, gibt GetFriendsAndColleagues eine XML-Zeichenfolge zurück, die Die Freunde des angemeldeten Benutzers im sozialen Netzwerk darstellt. Die XML-Zeichenfolge entspricht der FRIENDS-XML-Schemadefinition und gibt ein Personenelement (das auch der OSC-Anbieterschemadefinition entspricht) für jeden Freund an.
Wenn GetFriendsAndColleagues die Freundesinformationen für den angemeldeten Benutzer zurückgibt, speichert das OSC diese Informationen in einem Kontaktordner. Dieser Ordner ist spezifisch für das soziale Netzwerk und befindet sich im Outlook-Standardspeicher des angemeldeten Benutzers. Weitere Informationen dazu, wie die OSC die Informationen von Freunden in einem Kontaktordner zwischenspeichert, finden Sie unter Synchronisieren von Freunden und Aktivitäten.
Die im personsCollection-Parameter zurückgegebenen Informationen für jeden Freund entsprechen der XML-Schemadefinition für Person. Das Person-Element unterstützt viele Informationen für jeden Freund, einschließlich der SMTP-E-Mail-Adressen (die den Elementen emailAddress, emailAddress2 und emailAddress3 zugeordnet sind), die der Freund im sozialen Netzwerk angegeben hat, und die Benutzer-ID (die dem UserID-Element zugeordnet ist), die diesen Freund im sozialen Netzwerk identifiziert.
Um Aktivitäten für einen outlook-Benutzer anzuzeigen, der im Personen Bereich ausgewählt ist, versucht das OSC, den Benutzer mit jedem von GetFriendsAndColleagues zurückgegebenen Freund abzugleichen. Die OSC vergleicht dazu die SMTP-Adresse des ausgewählten Outlook-Benutzers mit den E-Mail-Adressen, die jeder Freund im sozialen Netzwerk angegeben hat. Wenn der OSC eine übereinstimmende SMTP-E-Mail-Adresse findet, verwendet der OSC die entsprechende userID des Freundes, um die ISocialSession::GetPerson-Methode aufzurufen. Dies geschieht, um ein ISocialPerson-Objekt für diesen Freund zu erhalten, das es dem OSC dann ermöglicht, Aktivitäten und Bilder dieses Freundes aus dem sozialen Netzwerk abzurufen.
Wenn der ausgewählte Outlook-Benutzer jedoch nicht dieselbe SMTP-Adresse für ein Konto im sozialen Netzwerk angibt oder wenn der Outlook-Benutzer kein Konto in diesem sozialen Netzwerk hat, kann das OSC keine Übereinstimmung für diesen Benutzer finden und zeigt keine Aktivitäten für diesen Benutzer im sozialen Netzwerk an.