Поделиться через

ISocialSession::LogonWeb

  • Статья

Входит на сайт социальной сети с помощью проверки подлинности на основе форм.

HRESULT _stdcall LogonWeb([in] BSTR connectIn, [out] BSTR* connectOut);

Параметры

connectIn

[в] Строка, которая имеет значение NULL, URL-адрес формы входа в Интернете или строка, содержащая учетные данные для входа в систему, в зависимости от контекста процесса входа при вызове этого метода.

connectOut

[out] Строка, содержащая учетные данные для входа.

Замечания

Outlook Social Connector (OSC) вызывает метод LogonWeb только в том случае, если поставщик указывает, что он поддерживает проверку подлинности на основе форм. Поставщик указывает, что ему требуется проверка подлинности на основе форм, задав параметру useLogonWebAuth значение true в XML-коде для возможностей. Если поставщик задает значение useLogonWebAuth как false, OSC использует обычную проверку подлинности и вызывает метод ISocialSession::Logon .

Вход на сайт социальной сети с помощью проверки подлинности на основе форм включает вызов методов LogonWeb и ISocialSession::GetLogonUrl в определенном порядке:

  1. OSC вызывает LogonWeb в первый раз, передав значение NULL параметру connectIn .

  2. Поставщик вызывает ошибку OSC_E_AUTH_ERROR в OSC.

  3. Затем OSC вызывает GetLogonUrl.

  4. Поставщик возвращает соответствующий URL-адрес для страницы входа в метод GetLogonUrl .

  5. OSC использует URL-адрес, возвращенный GetLogonUrl , для отображения страницы входа на основе форм.

  6. Затем OSC вызывает LogonWeb во второй раз, передав URL-адрес в форму входа в параметр connectIn .

  7. Если проверка подлинности прошла успешно, поставщик возвращает учетные данные для входа в параметр connectOut в OSC. Если проверка подлинности завершается ошибкой, поставщик вызывает ошибку OSC_E_AUTH_ERROR в OSC.

Если поставщик OSC поддерживает ведение журнала с использованием кэшированных учетных данных, он указывает useLogonCached как true в XML-коде возможностей . Поставщик должен поместить все учетные данные для входа в строку connectOut , которую поставщик хочет, чтобы OSC сохранял между подключениями. OSC не интерпретирует строку connectOut . После того как OSC проверит, что параметр useLogonCached имеет значение true, OSC шифрует строку для обеспечения безопасности, прежде чем сохранить ее в реестре Windows. OSC передает эту строку в параметр connectIn при последующих попытках войти в социальную сеть путем вызова ISocialSession2::LogonCached.

Сведения о кодах ошибок см. в статье Коды ошибок поставщика Outlook Social Connector.

См. также