Partager via


Fonction ApplyControlToken (sspi.h)

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

Voir aussi

DecryptMessage (Schannel)

ImpersonateSecurityContext

SCHANNEL_ALERT_TOKEN

SCHANNEL_SESSION_TOKEN

Fonctions SSPI

SecBuffer

SecBufferDesc