Partager via


DeleteSecurityContext, fonction (sspi.h)

La fonction DeleteSecurityContext supprime les structures de données locales associées au contexte de sécurité spécifié lancé par un appel précédent à la fonction InitializeSecurityContext (Général) ou à la fonction AcceptSecurityContext (Général).

Syntaxe

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY DeleteSecurityContext(
  [in] PCtxtHandle phContext
);

Paramètres

[in] phContext

Gérer le contexte de sécurité à supprimer.

Avertissement

N’utilisez pas le même handle de contexte dans les appels simultanés à DeleteSecurityContext. L’implémentation de l’API dans les fournisseurs de services de sécurité n’est pas thread-safe.

Valeur retournée

Si la fonction réussit ou si le handle a déjà été supprimé, la valeur de retour est SEC_E_OK.

Si la fonction échoue, la valeur de retour peut être le code d’erreur suivant :

Code de retour Description
SEC_E_INVALID_HANDLE Le handle passé à la fonction n’est pas valide.

Remarques

La fonction DeleteSecurityContext met fin à un contexte de sécurité et libère les ressources associées.

L’appelant doit appeler cette fonction pour un contexte de sécurité lorsque ce contexte de sécurité n’est plus nécessaire. Cela est vrai si le contexte de sécurité est partiel, incomplet, rejeté ou a échoué. Une fois le contexte de sécurité supprimé, l’utilisation ultérieure de ce contexte de sécurité n’est plus autorisée et le handle n’est plus valide.

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

AcceptSecurityContext (Général)

InitializeSecurityContext (Général)

Fonctions SSPI