Freigeben über

ISocialSession::LogonWeb

  • Artikel

Melden Sie sich mithilfe der formularbasierten Authentifizierung bei der Website des sozialen Netzwerks an.

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

Parameter

connectIn

[in] Eine Zeichenfolge, die NULL ist, eine URL zu einem Anmeldeformular im Web oder eine Zeichenfolge, die Anmeldeinformationen enthält, abhängig vom Kontext im Anmeldeprozess, wenn diese Methode aufgerufen wird.

connectOut

[out] Eine Zeichenfolge, die Anmeldeinformationen enthält.

Hinweise

Der Outlook Connector für soziale Netzwerke (OSC) ruft die LogonWeb-Methode nur auf, wenn der Anbieter angibt, dass er die formularbasierte Authentifizierung unterstützt. Der Anbieter gibt an, dass die formularbasierte Authentifizierung erforderlich ist, indem er useLogonWebAuth im XML-Code für Funktionen als true festlegt. Wenn der Anbieter useLogonWebAuth als false festlegt, verwendet der OSC die Standardauthentifizierung und ruft die ISocialSession::Logon-Methode auf.

Das Anmelden bei einer Website eines sozialen Netzwerks mithilfe der formularbasierten Authentifizierung umfasst das Aufrufen der Methoden LogonWeb und ISocialSession::GetLogonUrl in einer bestimmten Reihenfolge:

  1. Der OSC ruft LogonWeb beim ersten Mal auf und übergibt NULL an den connectIn-Parameter .

  2. Der Anbieter löst den OSC_E_AUTH_ERROR Fehler an die OSC aus.

  3. Die OSC ruft als Nächstes GetLogonUrl auf.

  4. Der Anbieter gibt die entsprechende URL zu einer Anmeldeseite in der GetLogonUrl-Methode zurück.

  5. Der OSC verwendet die von GetLogonUrl zurückgegebene URL, um die formularbasierte Anmeldeseite anzuzeigen.

  6. Der OSC ruft dann logonWeb ein zweites Mal auf und übergibt die URL an das Anmeldeformular im connectIn-Parameter .

  7. Wenn die Authentifizierung erfolgreich ist, gibt der Anbieter Anmeldeinformationen im connectOut-Parameter an die OSC zurück. Wenn die Authentifizierung fehlschlägt, löst der Anbieter den OSC_E_AUTH_ERROR Fehler an die OSC aus.

Wenn der OSC-Anbieter die Anmeldung mit zwischengespeicherten Anmeldeinformationen unterstützt, wird useLogonCached im Funktions-XML als true angegeben. Der Anbieter sollte alle Anmeldeinformationen in der connectOut-Zeichenfolge platzieren, die der Anbieter vom OSC über Verbindungen hinweg speichern soll. Der OSC interpretiert die connectOut-Zeichenfolge nicht. Nachdem die OSC überprüft hat, dass useLogonCachedtrue ist, verschlüsselt der OSC die Zeichenfolge aus Sicherheitsgründen, bevor sie in der Windows-Registrierung gespeichert wird. Der OSC übergibt diese Zeichenfolge an den connectIn-Parameter bei nachfolgenden Anmeldeversuchen beim sozialen Netzwerk, indem ISocialSession2::LogonCached aufgerufen wird.

Informationen zu Fehlercodes finden Sie unter Outlook Social Connector-Anbieter – Fehlercodes.

Siehe auch