ISocialSession2::GetPeopleDetails
Gibt eine Zeichenfolge zurück, die eine Auflistung von Personen- und Bilddetails für die Benutzer enthält, die durch den personsAddresses-Parameter angegeben werden.
HRESULT _stdcall GetPeopleDetails([in] BSTR personsAddresses, [out, retval] BSTR* personsCollection);
Parameter
personsAddresses
[in] Eine XML-Zeichenfolge, die die gehashten SMTP-Adressen einer Gruppe von Benutzern angibt.
personsCollection
[out] Eine XML-Zeichenfolge, die eine Auflistung von Personen- und Bilddetails enthält.
Hinweise
Der Outlook Connector für soziale Netzwerke (OSC) ruft GetPeopleDetails auf, wenn der OSC-Anbieter die bedarfsgesteuerte oder hybride Synchronisierung von Freunden und Nicht-Freunden unterstützt.
Der personsAddresses-Parameter muss der Schemadefinition für hashedAddresses entsprechen, die im Schema für osc-Anbietererweiterung definiert ist. Die personsAddresses-Zeichenfolge stellt einen Satz gehashter SMTP-Adressen für jeden Benutzer dar, der im bereich Personen angezeigt wird. Der Benutzer muss kein Freund des angemeldeten Benutzers sein, der durch die ISocialSession::LoggedOnUserName-Eigenschaft dargestellt wird. Die gehashten SMTP-Adressen werden mithilfe der Hashfunktion verschlüsselt, die durch das hashFunction-Element im Funktions-XML des Anbieters angegeben wird. Der OSC identifiziert jede hashedAddress in der personAddresses-Auflistung mit einem index-Element . Der Anbieter muss das index-Element verwenden, um die Personen-XML des Empfängers zu identifizieren, wenn er Friends-XML für GetPeopleDetails zurückgibt. Wenn der Empfänger kein registrierter Benutzer im sozialen Netzwerk ist, darf der Anbieter keine Personen-XML für diesen Empfänger zurückgeben. Das index-Element für jeden Netzwerkbenutzer, der durch personen-XML dargestellt wird, entspricht dem index-Element für den Empfänger in personsAddresses.
Der OSC speichert die vom personsCollection-Parameter zurückgegebenen Informationen im Arbeitsspeicher. Die xml-Zeichenfolge personsCollection muss der Schemadefinition für Freunde entsprechen, die im Schema für osc-Anbietererweiterung definiert ist. Weitere Informationen dazu, wie osc diese Informationen im Arbeitsspeicher verwendet und aktualisiert, finden Sie unter Synchronisieren von Freunden und Aktivitäten.