Share via

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 方法：

  1. OSC 首次调用 LogonWeb ，将 null 传递给 connectIn 参数。

  2. 提供程序向 OSC 引发OSC_E_AUTH_ERROR错误。

  3. OSC 接下来调用 GetLogonUrl。

  4. 提供程序在 GetLogonUrl 方法中返回登录页的相应 URL。

  5. OSC 使用 GetLogonUrl 返回的 URL 来显示基于表单的登录页。

  6. 然后，OSC 再次调用 LogonWeb ，将 URL 传递到 connectIn 参数中的登录表单。

  7. 如果身份验证成功，提供程序会将 connectOut 参数中的登录凭据返回到 OSC。 如果身份验证失败，提供程序会向 OSC 引发OSC_E_AUTH_ERROR错误。

如果 OSC 提供程序支持使用缓存凭据登录，则会在功能 XML 中将 useLogonCached 指定为 true。 提供程序应在 connectOut 字符串中放置提供程序希望 OSC 跨连接存储的任何登录凭据。 OSC 不解释 connectOut 字符串。 OSC 验证 useLogonCached 为 true 后，OSC 会先加密字符串以确保安全性，然后再将其存储在 Windows 注册表中。 OSC 在后续尝试通过调用 ISocialSession2：：LogonCached 登录到社交网络时将此字符串传递给 connectIn 参数。

有关错误代码信息，请参阅 Outlook Social Connector 提供程序错误代码。

另请参阅