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

Consulte también

AcquireCredentialsHandle (General)

Funciones SSPI