Méthode ITSGAuthorizeConnectionSink ::OnConnectionAuthorized (tsgpolicyengine.h)

Article
08/26/2023

Avertit la passerelle Bureau à distance (passerelle Bureau à distance) du résultat d’une tentative d’autorisation d’une connexion.

Syntaxe

HRESULT OnConnectionAuthorized(
  [in] HRESULT                     hrIn,
  [in] GUID                        mainSessionId,
  [in] ULONG                       cbSoHResponse,
  [in] BYTE                        *pbSoHResponse,
  [in] ULONG                       idleTimeout,
  [in] ULONG                       sessionTimeout,
  [in] SESSION_TIMEOUT_ACTION_TYPE sessionTimeoutAction,
  [in] AATrustClassID              trustClass,
  [in] PolicyAttributes            policyAttributes
);

Paramètres

[in] hrIn

Résultat de la tentative d’autorisation. Spécifiez S_OK pour indiquer que la tentative a réussi. Spécifiez toute autre valeur pour indiquer que la tentative a échoué.

[in] mainSessionId

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

[in] cbSoHResponse

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

[in] pbSoHResponse

Pointeur vers un BYTE qui spécifie la réponse à la demande d’une déclaration d’intégrité (SoH). Si le paramètre hrIn n’est pas S_OK, ce paramètre est ignoré.

[in] idleTimeout

Nombre de minutes pendant lesquelles la connexion peut rester inactive avant d’être déconnectée. Si le paramètre hrIn n’est pas S_OK, ce paramètre est ignoré.

[in] sessionTimeout

Nombre maximal de minutes allouées à la session. Si le paramètre hrIn n’est pas S_OK, ce paramètre est ignoré.

[in] sessionTimeoutAction

Action à effectuer lorsque la session expire. Si le paramètre hrIn n’est pas S_OK, ce paramètre est ignoré. Ce paramètre peut prendre les valeurs suivantes.

SESSION_TIMEOUT_ACTION_DISCONNECT

Déconnectez la session.

SESSION_TIMEOUT_ACTION_SILENT_REAUTH

Réauthentification silencieuse et réauthentification de la session.

[in] trustClass

Ce paramètre est réservé. Définissez-le toujours sur AA_TRUSTEDUSER_TRUSTEDCLIENT. Si le paramètre hrIn n’est pas S_OK, ce paramètre est ignoré.

[in] policyAttributes

Tableau de valeurs booléennes qui spécifient les paramètres de redirection associés à la connexion. Chaque élément du tableau correspond à une valeur de l’énumération PolicyAttributeType . Si le paramètre hrIn n’est pas S_OK, ce paramètre est ignoré.

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 d’AuthorizeConnection. 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 OnConnectionAuthorized , 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	tsgpolicyengine.h

Voir aussi

ITSGAuthorizeConnectionSink

Partager via