Fonction ApplyControlToken (sspi.h)

Article
03/02/2024

La fonction ApplyControlToken permet d’appliquer un jeton de contrôle à un contexte de sécurité. Un jeton peut être reçu lorsque le contexte de sécurité est en cours d’établissement par un appel à la fonction InitializeSecurityContext (Schannel) ou avec un service de sécurité par message, tel que la vérification ou la désinstallation.

Cette fonction est prise en charge uniquement par le fournisseur de support de sécurité Schannel (SSP).

Cette fonction n’est pas prise en charge en mode noyau.

Cette fonction permet d’appliquer des jetons supplémentaires ou de remplacement à un contexte.

Syntaxe

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ApplyControlToken(
  [in] PCtxtHandle    phContext,
  [in] PSecBufferDesc pInput
);

Paramètres

[in] phContext

Handle du contexte auquel le jeton est appliqué.

Pour plus d’informations sur la façon dont le fournisseur SSP Schannel avertit la partie distante de l’arrêt, consultez la section Remarques de DecryptMessage (Schannel). Pour plus d’informations sur l’utilisation de cette fonction, consultez Arrêter une connexion Schannel.

[in] pInput

Pointeur vers une structure SecBufferDesc qui contient un pointeur vers une structure SecBuffer qui contient le jeton d’entrée à appliquer au contexte.

Valeur retournée

Si la fonction réussit, la fonction retourne SEC_E_OK.

Si la fonction échoue, elle retourne un code d’erreur différent de zéro. Le code d’erreur suivant est l’un des codes d’erreur possibles qui peuvent être retournés.

Code de retour	Description
SEC_E_UNSUPPORTED_FUNCTION	Cette valeur est retournée par le mode noyau Schannel pour indiquer que cette fonction n’est pas prise en charge.

Remarques

La fonction ApplyControlToken peut modifier le contexte en fonction de ce jeton. Parmi les jetons que cette fonction peut ajouter au contexte client figurent SCHANNEL_ALERT_TOKEN et SCHANNEL_SESSION_TOKEN.

Cette fonction peut être utilisée pour arrêter le contexte de sécurité qui sous-tend une connexion Schannel existante. Pour plus d’informations sur la procédure à suivre, consultez Arrêt d’une connexion Schannel.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	sspi.h (include Security.h)
Bibliothèque	Secur32.lib
DLL	Secur32.dll