Funzione SspiDeleteSecurityContextAsync (sspi.h)

Articolo
08/26/2023

La funzione SspiDeleteSecurityContextAsync elimina le strutture di dati locali associate al contesto di sicurezza specificato avviato da una chiamata precedente alla funzione SspiInitializeSecurityContextAsync o alla funzione SspiAcceptSecurityContextAsync .

Sintassi

SECURITY_STATUS SspiDeleteSecurityContextAsync(
  SspiAsyncContext *AsyncContext,
  PCtxtHandle      phContext
);

Parametri

AsyncContext

Contesto di chiamata asincrona.

phContext

Handle del contesto di sicurezza da eliminare.

Valore restituito

Restituisce SEC_E_OK se la richiesta asincrona per eliminare il contesto di sicurezza è stata accodata correttamente per l'esecuzione. In caso contrario, restituisce l'errore generato durante il tentativo di accodarlo. Per recuperare lo stato dell'operazione, usare SspiGetAsyncCallStatus.

SspiGetAsyncCallStatus restituisce SEC_E_OK al completamento. In caso contrario, può restituire SEC_I_ASYNC_CALL_PENDING se la chiamata è ancora in corso o uno dei codici di errore seguenti.

Codice restituito	Descrizione
SEC_E_INVALID_HANDLE	L'handle passato alla funzione non è valido.

Commenti

Al completamento di una chiamata asincrona, i chiamanti possono scegliere di rifiutare esplicitamente la ricezione di una notifica evitando di impostare un callback per un nuovo SspiAsyncContext o rimuovendo il callback usando SspiSetAsyncNotifyCallback con un parametro Null. Se si rifiuta esplicitamente, il chiamante deve liberare il contesto con SspiFreeAsyncContext immediatamente dopo aver chiamato SspiDeleteSecurityContextAsync, a meno che il contesto non sia destinato al riutilizzo.

La funzione SspiDeleteSecurityContextAsync termina un contesto di sicurezza e libera le risorse associate.

Il chiamante deve chiamare questa funzione per un contesto di sicurezza quando tale contesto di sicurezza non è più necessario. Ciò vale se il contesto di sicurezza è parziale, incompleto, rifiutato o non riuscito. Dopo l'eliminazione del contesto di sicurezza, non è consentito un ulteriore utilizzo del contesto di sicurezza e l'handle non è più valido.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 1607 [solo driver in modalità kernel]
Server minimo supportato	Windows Server 2016 [solo driver in modalità kernel]
Intestazione	sspi.h