Compartilhar via


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

Confira também

AcquireCredentialsHandle (Geral)

Funções SSPI