Función FreeCredentialsHandle (sspi.h)
La función FreeCredentialsHandle notifica al sistema de seguridad que las credenciales ya no son necesarias. Una aplicación llama a esta función para liberar el identificador de credencial adquirido en la llamada a la función AcquireCredentialsHandle (General) después de llamar a la función DeleteSecurityContext para liberar cualquier identificador de contexto asociado a la credencial. Cuando se han quitado todas las referencias a este conjunto de credenciales, se pueden quitar las propias credenciales.
Si no se liberan identificadores de credenciales, se producirán pérdidas de memoria.
Sintaxis
KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY FreeCredentialsHandle(
[in] PCredHandle phCredential
);
Parámetros
[in] phCredential
Puntero al identificador CredHandle obtenido mediante la función AcquireCredentialsHandle (General ).
Valor devuelto
Si la función se realiza correctamente, la función devuelve SEC_E_OK.
Si se produce un error en la función, devuelve el siguiente código de error.
| Código devuelto | Descripción |
|---|---|
|
El identificador pasado a la función no es válido. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | sspi.h (include Security.h) |
| Library | Secur32.lib |
| Archivo DLL | Secur32.dll |