SspiDeleteSecurityContextAsync, fonction (sspi.h)
La fonction SspiDeleteSecurityContextAsync supprime les structures de données locales associées au contexte de sécurité spécifié initié par un appel précédent à la fonction SspiInitializeSecurityContextAsync ou à la fonction SspiAcceptSecurityContextAsync .
Syntaxe
SECURITY_STATUS SspiDeleteSecurityContextAsync(
SspiAsyncContext *AsyncContext,
PCtxtHandle phContext
);
Paramètres
AsyncContext
Contexte d’appel asynchrone.
phContext
Gérer le contexte de sécurité à supprimer.
Valeur retournée
Retourne SEC_E_OK si la demande asynchrone de suppression du contexte de sécurité a été correctement mise en file d’attente pour l’exécution. Sinon, il retourne l’erreur générée lors de la tentative de mise en file d’attente. Pour récupérer les status de l’opération, utilisez SspiGetAsyncCallStatus.
SspiGetAsyncCallStatus retourne SEC_E_OK à l’achèvement. Sinon, il peut retourner SEC_I_ASYNC_CALL_PENDING si l’appel est toujours en cours, ou l’un des codes d’erreur ci-dessous.
Code de retour |
Description |
|---|---|
| SEC_E_INVALID_HANDLE | Le handle passé à la fonction n’est pas valide. |
Remarques
À la fin de l’appel asynchrone, les appelants peuvent choisir de ne pas recevoir une notification en évitant de définir un rappel pour un nouveau SspiAsyncContext ou en supprimant le rappel à l’aide de SspiSetAsyncNotifyCallback avec un paramètre null. En cas de refus, l’appelant doit libérer le contexte avec SspiFreeAsyncContext immédiatement après l’appel de SspiDeleteSecurityContextAsync, sauf si le contexte est destiné à une réutilisation.
La fonction SspiDeleteSecurityContextAsync 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 10, version 1607 [pilotes en mode noyau uniquement] |
| Serveur minimal pris en charge | Windows Server 2016 [pilotes en mode noyau uniquement] |
| En-tête | sspi.h |
Voir aussi
SspiAcceptSecurityContextAsync