Função FreeCredentialsHandle (sspi.h)
A função FreeCredentialsHandle notifica o sistema de segurança de que as credenciais não são mais necessárias. Um aplicativo chama essa função para liberar o identificador de credencial adquirido na chamada para a função AcquireCredentialsHandle (Geral) depois de chamar a função DeleteSecurityContext para liberar todos os identificadores de contexto associados à credencial. Quando todas as referências a esse conjunto de credenciais tiverem sido removidas, as próprias credenciais poderão ser removidas.
A falha ao liberar identificadores de credenciais resultará em vazamentos de memória.
Sintaxe
KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY FreeCredentialsHandle(
[in] PCredHandle phCredential
);
Parâmetros
[in] phCredential
Um ponteiro para o identificador CredHandle obtido usando a função AcquireCredentialsHandle (Geral ).
Retornar valor
Se a função for bem-sucedida, a função retornará SEC_E_OK.
Se a função falhar, ela retornará o código de erro a seguir.
| Código de retorno | Descrição |
|---|---|
|
O identificador passado para a função não é válido. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | sspi.h (inclua Security.h) |
| Biblioteca | Secur32.lib |
| DLL | Secur32.dll |