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)