Fonction CompleteAuthToken (sspi.h)

Article
03/02/2024

La fonction CompleteAuthToken termine un jeton d’authentification. Cette fonction est utilisée par les protocoles, tels que DCE, qui doivent réviser les informations de sécurité une fois que l’application de transport a mis à jour certains paramètres de message.

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

CompleteAuthToken est utilisé côté serveur uniquement.

Syntaxe

SECURITY_STATUS SEC_ENTRY CompleteAuthToken(
  [in] PCtxtHandle    phContext,
  [in] PSecBufferDesc pToken
);

Paramètres

[in] phContext

Handle du contexte qui doit être terminé.

[in] pToken

Pointeur vers une structure SecBufferDesc qui contient le descripteur de mémoire tampon pour l’ensemble du message.

Valeur retournée

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

Si la fonction échoue, elle retourne l’un des codes d’erreur suivants.

Code de retour	Description
SEC_E_INVALID_HANDLE	Le handle qui a été passé à la fonction n’est pas valide.
SEC_E_INVALID_TOKEN	Le jeton qui a été passé à la fonction n’est pas valide.
SEC_E_OUT_OF_SEQUENCE	Le contexte de sécurité du client était localisé, mais le numéro de message est incorrect. Cette valeur de retour est utilisée avec le fournisseur de services partagé Digest.
SEC_E_MESSAGE_ALTERED	Le contexte de sécurité du client a été localisé, mais le message du client a été falsifié. Cette valeur de retour est utilisée avec le fournisseur de services partagé Digest.
SEC_E_INTERNAL_ERROR	Une erreur s’est produite qui n’a pas été mappée à un code d’erreur SSPI.

Remarques

Le client d’une application de transport appelle la fonction CompleteAuthToken pour permettre au package de sécurité de mettre à jour une somme de contrôle ou une opération similaire une fois que tous les en-têtes de protocole ont été mis à jour par l’application de transport. Le client appelle cette fonction uniquement si l’appel InitializeSecurityContext (Digest) a retourné SEC_I_COMPLETE_NEEDED ou SEC_I_COMPLETE_AND_CONTINUE.

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

InitializeSecurityContext (Digest)

Fonctions SSPI

SecBufferDesc

Partager via