ISocialSession2::FollowPersonEx
emailAddresses パラメーターと displayName パラメーターによって識別されたユーザーを、ソーシャル ネットワーク上のログオン ユーザーのフレンドとして追加します。
HRESULT _stdcall FollowPersonEx([in] SAFEARRAY(BSTR) emailAddresses, [in] BSTR displayName);
パラメーター
emailAddresses
[in]ソーシャル ネットワーク上のユーザーの 1 つまたは複数の有効な SMTP アドレスを含む配列。
displayName
[in]フレンドとして追加するユーザーの表示名を含む文字列。
注釈
Outlook Social Connector (OSC) が emailAddresses パラメーターの配列内の SMTP アドレスよりも多くを提供する場合、OSC プロバイダーは、最初の要素がプライマリ SMTP アドレスであると想定できます。
プロバイダーが機能 XML で followPerson 要素を true に設定していて、emailAddresses の要素がネットワーク上のユーザーと一致しない場合、プロバイダーはOSC_E_NOT_FOUNDエラーを返す必要があります。 プロバイダーが機能で followPerson をfalse に設定している場合、プロバイダーは OSC_E_FAIL エラーを返す必要があります。
FollowPersonEx メソッドが成功した場合、プロバイダーは displayName パラメーターの文字列を使用して、SMTP アドレスでユーザーにアドレスを指定するのではなく、後続のフレンド確認メールのユーザーにアドレスを指定できます。 一方、プロバイダーは、 displayName パラメーターの空の文字列を渡す OSC を処理できる必要があります。
プロバイダーが ISocialSession2 インターフェイスを実装し、機能 XML で followPerson を true に設定した場合、OSC は ISocialSession::FollowPerson の代わりに FollowPersonEx を呼び出します。 プロバイダーが followPerson をtrue に設定したが ISocialSession2 インターフェイスを実装していない場合、または FollowPersonEx が OSC_E_NOTIMPL エラーを返す場合、OSC は ISocialSession::FollowPerson を呼び出します。