Funzione FreeCredentialsHandle (sspi.h)
La funzione FreeCredentialsHandle notifica al sistema di sicurezza che le credenziali non sono più necessarie. Un'applicazione chiama questa funzione per liberare l'handle delle credenziali acquisito nella chiamata alla funzione AcquireCredentialsHandle (Generale) dopo aver chiamato la funzione DeleteSecurityContext per liberare qualsiasi handle di contesto associato alla credenziale. Quando tutti i riferimenti a questo set di credenziali sono stati rimossi, è possibile rimuovere le credenziali stesse.
Se non si liberano gli handle delle credenziali, si verifica una perdita di memoria.
Sintassi
KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY FreeCredentialsHandle(
[in] PCredHandle phCredential
);
Parametri
[in] phCredential
Puntatore all'handle CredHandle ottenuto usando la funzione AcquireCredentialsHandle (General).
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce SEC_E_OK.
Se la funzione ha esito negativo, restituisce il codice di errore seguente.
| Codice restituito | Descrizione |
|---|---|
|
L'handle passato alla funzione non è 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 |