Funzione DeleteSecurityContext (sspi.h)

La funzione DeleteSecurityContext elimina le strutture di dati locali associate al contesto di sicurezza specificato avviato da una chiamata precedente alla funzione InitializeSecurityContext (General) o alla funzione AcceptSecurityContext (General).

Sintassi

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

Parametri

[in] phContext

Handle del contesto di sicurezza da eliminare.

Avviso

Non usare lo stesso handle di contesto nelle chiamate simultanee a DeleteSecurityContext. L'implementazione dell'API nei provider di servizi di sicurezza non è thread-safe.

Valore restituito

Se la funzione ha esito positivo o l'handle è già stato eliminato, il valore restituito è SEC_E_OK.

Se la funzione ha esito negativo, il valore restituito può essere il codice di errore seguente:

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

Commenti

La funzione DeleteSecurityContext 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 XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	sspi.h (include Security.h)
Libreria	Secur32.lib
DLL	Secur32.dll

Vedi anche

AcceptSecurityContext (Generale)

InitializeSecurityContext (Generale)

Funzioni SSPI