ISocialSession::LogonWeb
フォーム ベースの認証を使用して、ソーシャル ネットワーク サイトにログオンします。
HRESULT _stdcall LogonWeb([in] BSTR connectIn, [out] BSTR* connectOut);
パラメーター
connectIn
[in]このメソッドが呼び出されたときのログオン プロセスのコンテキストに応じて、 null の文字列、Web 上のログオン フォームへの URL、またはログオン資格情報を含む文字列。
connectOut
[out]ログオン資格情報を含む文字列。
注釈
Outlook Social Connector (OSC) は、プロバイダーがフォーム ベースの認証をサポートしていることを示している場合にのみ LogonWeb メソッドを呼び出します。 プロバイダーは、機能の XML で useLogonWebAuth を true に設定することで、フォーム ベースの認証が必要であることを示 します。 プロバイダーが useLogonWebAuthを false に設定した場合、OSC は基本認証を使用し、 ISocialSession::Logon メソッドを 呼び出します。
フォーム ベースの認証を使用してソーシャル ネットワーク サイトにログオンするには、 LogonWeb メソッドと ISocialSession::GetLogonUrl メソッドを特定の順序で呼び出す必要があります。
OSC は LogonWeb を初めて呼び出し、connectIn パラメーターに null を渡します。
プロバイダーは、OSC にOSC_E_AUTH_ERROR エラーを発生させます。
OSC は次に GetLogonUrl を呼び出します。
プロバイダーは、 GetLogonUrl メソッドのログオン ページに適切な URL を返します。
OSC は 、GetLogonUrl によって返される URL を使用して、フォーム ベースのログオン ページを表示します。
その後、OSC は LogonWeb を 2 回目に呼び出し、 connectIn パラメーターのログオン フォームに URL を渡します。
認証が成功した場合、プロバイダーは connectOut パラメーターのログオン資格情報を OSC に返します。 認証が失敗した場合、プロバイダーは OSC にOSC_E_AUTH_ERRORエラーを発生させます。
OSC プロバイダーがキャッシュされた資格情報を使用したログオンをサポートしている場合は、機能 XML で useLogonCached を true として指定します。 プロバイダーは、接続間で OSC に格納する 必要がある connectOut 文字列にログオン資格情報を配置する必要があります。 OSC は connectOut 文字列を解釈しません。 OSC が useLogonCached が true であることを確認した後、OSC はセキュリティのために文字列を暗号化してから Windows レジストリに格納します。 OSC は、後続の ISocialSession2::LogonCached を呼び出してソーシャル ネットワークにログオンしようとすると、この文字列を connectIn パラメーターに渡します。
エラー コードの詳細については、「Outlook Social Connector Provider Error Codes」を参照してください。