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
SEC_E_INVALID_HANDLE	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

Vedi anche

AcquireCredentialsHandle (Generale)

Funzioni SSPI