Condividi tramite


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