Partager via


Fonction CompleteAuthToken (sspi.h)

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