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)