ISocialPerson::GetFriendsAndColleagues
ユーザーのコレクションを表す文字列を取得します。
HRESULT _stdcall GetFriendsAndColleagues([out, retval] BSTR* personsCollection);
パラメーター
personsCollection
[out]ユーザーのフレンドのセットを表し、Outlook Social Connector (OSC) プロバイダー拡張の XML スキーマで定義されている フレンド の定義に準拠する XML 文字列。
注釈
OSC プロバイダーがソーシャル ネットワーク上のフレンドのキャッシュまたはハイブリッド同期をサポートしている場合、OSC は GetFriendsAndColleagues を呼び出します。 OSC が最初に、ソーシャル ネットワークにログオンしている Outlook ユーザーの GetFriendsAndColleagues メソッドを呼び出すと、 GetFriendsAndColleagues は、ソーシャル ネットワーク上のログオンユーザーのフレンドを表す XML 文字列を返します。 XML 文字列はフレンド XML スキーマ定義に準拠し、 フレンド ごとに person 要素 (OSC プロバイダー スキーマ定義にも準拠) を指定します。
GetFriendsAndColleagues がログオン ユーザーのフレンド情報を返すと、OSC はその情報を連絡先フォルダーに格納します。 このフォルダーはソーシャル ネットワークに固有であり、ログオンしているユーザーの既定の Outlook ストアに存在します。 OSC が連絡先フォルダーにフレンドの情報をキャッシュする方法の詳細については、「 フレンドとアクティビティの同期」を参照してください。
personsCollection パラメーターで返される各フレンドの情報は、person の XML スキーマ定義に準拠しています。 person 要素は、フレンドがソーシャル ネットワークで指定した SMTP メール アドレス (emailAddress、emailAddress2、emailAddress3 要素にマップ) や、ソーシャル ネットワーク上でそのフレンドを識別するユーザー ID (userID 要素にマップ) など、フレンドごとに多くの情報をサポートします。
People ウィンドウで選択した Outlook ユーザーのアクティビティを表示するために、OSC は GetFriendsAndColleagues から返された各フレンドとユーザーの照合を試みます。 OSC は、選択した Outlook ユーザーの SMTP アドレスと、各フレンドがソーシャル ネットワークで指定したメール アドレスを照合することでこれを行います。 OSC が一致する SMTP メール アドレスを検出した場合、OSC はフレンドの対応する userID を 使用して ISocialSession::GetPerson メソッドを呼び出します。 これは、その友人の ISocialPerson オブジェクトを取得するためにこれを行い、OSC がソーシャル ネットワークからその友人のアクティビティと写真を取得できるようにします。
ただし、選択した Outlook ユーザーがソーシャル ネットワーク上のアカウントで同じ SMTP アドレスを指定していない場合、または Outlook ユーザーがそのソーシャル ネットワークにアカウントを持っていない場合、OSC はそのユーザーの一致を見つけることができず、ソーシャル ネットワーク上のそのユーザーのアクティビティは表示されません。