Méthode ITSGAuthenticateUserSink ::OnUserAuthenticationFailed (tsgauthenticationengine.h)

Article
03/03/2024

Avertit la passerelle Bureau à distance que le plug-in d’authentification n’a pas réussi à authentifier l’utilisateur.

Syntaxe

HRESULT OnUserAuthenticationFailed(
  [in] ULONG_PTR context,
  [in] HRESULT   genericErrorCode,
  [in] HRESULT   specificErrorCode
);

Paramètres

[in] context

Pointeur vers un ULONG qui contient une valeur qui identifie cette connexion. Utilisez la valeur qui a été transmise par la méthode AuthenticateUser .

[in] genericErrorCode

Code d’erreur Windows qui spécifie la cause de l’échec de l’authentification.

[in] specificErrorCode

Ce paramètre est réservé. Définissez toujours ce paramètre sur zéro.

Valeur retournée

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

Remarques

Vous pouvez appeler cette méthode à partir de votre implémentation de AuthenticateUser. Si l’authentification nécessite plus d’une seconde, nous vous recommandons de lancer un thread distinct pour effectuer l’authentification.

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

Configuration requise

Condition requise	Valeur
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

ITSGAuthenticateUserSink

Partager via