Méthode ITSGAuthenticationEngine::AuthenticateUser (tsgauthenticationengine.h)

Article
08/26/2023

Authentifie un utilisateur.

La passerelle Bureau à distance appelle cette méthode lorsqu’elle reçoit une nouvelle demande de connexion. Le plug-in d’authentification doit authentifier l’utilisateur en fonction du cookie référencé par le paramètre cookieData . Le plug-in d’authentification doit ensuite utiliser l’interface ITSGAuthenticateUserSink pour informer la passerelle Bureau à distance du résultat de l’authentification.

Syntaxe

HRESULT AuthenticateUser(
  [in] GUID                     mainSessionId,
  [in] BYTE                     *cookieData,
  [in] ULONG                    numCookieBytes,
  [in] ULONG_PTR                context,
  [in] ITSGAuthenticateUserSink *pSink
);

Paramètres

[in] mainSessionId

Identificateur unique attribué à la demande de connexion par la passerelle Bureau à distance.

[in] cookieData

Pointeur vers un BYTE qui contient le cookie fourni par l’utilisateur.

[in] numCookieBytes

Nombre d’octets référencés par le paramètre cookieData .

[in] context

Pointeur vers un ULONG qui contient une valeur spécifique à cette connexion. Cette valeur doit être renvoyée à la passerelle Bureau à distance à l’aide des méthodes de l’interface ITSGAuthenticateUserSink .

[in] pSink

Pointeur vers une interface ITSGAuthenticateUserSink que le plug-in d’authentification doit utiliser pour informer la passerelle Bureau à distance du résultat de l’authentification.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Si cette méthode retourne S_OK, la passerelle Bureau à distance attend que le plug-in d’authentification appelle une méthode de l’interface ITSGAuthenticateUserSink . Si une autre valeur est retournée, la passerelle Bureau à distance refuse immédiatement la demande de connexion.

Pour obtenir un exemple qui utilise la méthode AuthenticateUser , consultez l’exemple d’authentification et d’autorisation enfichable de la passerelle Bureau à distance .

Configuration requise


Client minimal pris en charge	Windows 7
Serveur minimal pris en charge	Windows Server 2008 R2
Plateforme cible	Windows
En-tête	tsgauthenticationengine.h

Voir aussi

ITSGAuthenticationEngine

Partager via