Partager via

ISocialSession::LogonWeb

  • Article

Se connecte au site de réseau social à l’aide de l’authentification basée sur les formulaires.

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

Paramètres

connectIn

[in] Chaîne null, URL d’un formulaire d’ouverture de session sur le web ou chaîne contenant des informations d’identification d’ouverture de session, selon le contexte du processus d’ouverture de session lorsque cette méthode est appelée.

connectOut

[out] Chaîne qui contient les informations d’identification d’ouverture de session.

Remarques

Outlook Social Connector (OSC) appelle la méthode LogonWeb uniquement si le fournisseur indique qu’il prend en charge l’authentification basée sur les formulaires. Le fournisseur indique qu’il nécessite une authentification basée sur les formulaires en définissant useLogonWebAuth sur true dans le code XML pour les fonctionnalités. Si le fournisseur définit useLogonWebAuth sur false, l’OSC utilise l’authentification de base et appelle la méthode ISocialSession ::Logon .

La connexion à un site de réseau social à l’aide de l’authentification basée sur les formulaires implique d’appeler les méthodes LogonWeb et ISocialSession ::GetLogonUrl dans un ordre spécifique :

  1. L’OSC appelle LogonWeb la première fois, en passant null au paramètre connectIn .

  2. Le fournisseur génère l’erreur OSC_E_AUTH_ERROR à l’OSC.

  3. L’OSC appelle ensuite GetLogonUrl.

  4. Le fournisseur retourne l’URL appropriée à une page d’ouverture de session dans la méthode GetLogonUrl .

  5. L’OSC utilise l’URL retournée par GetLogonUrl pour afficher la page d’ouverture de session basée sur les formulaires.

  6. L’OSC appelle ensuite LogonWeb une deuxième fois, en passant l’URL au formulaire d’ouverture de session dans le paramètre connectIn .

  7. Si l’authentification réussit, le fournisseur retourne les informations d’identification de connexion dans le paramètre connectOut au OSC. Si l’authentification échoue, le fournisseur déclenche l’erreur OSC_E_AUTH_ERROR à l’OSC.

Si le fournisseur OSC prend en charge la connexion à l’aide d’informations d’identification mises en cache, il spécifie useLogonCached comme true dans le code XML des fonctionnalités . Le fournisseur doit placer toutes les informations d’identification d’ouverture de session dans la chaîne connectOut que le fournisseur souhaite que l’OSC stocke entre les connexions. L’OSC n’interprète pas la chaîne connectOut . Une fois que l’OSC a vérifié que useLogonCached a la valeur true, l’OSC chiffre la chaîne pour la sécurité avant de la stocker dans le Registre Windows. L’OSC transmet cette chaîne au paramètre connectIn lors des tentatives suivantes de connexion au réseau social en appelant ISocialSession2 ::LogonCached.

Pour plus d’informations sur les codes d’erreur, consultez la rubrique relative aux codes d’erreur du fournisseur Outlook Social Connector.

Voir aussi