SspiDeleteSecurityContextAsync, fonction (sspi.h)

Article
08/26/2023

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