Função DeleteSecurityContext (sspi.h)

A função DeleteSecurityContext exclui as estruturas de dados locais associadas ao contexto de segurança especificado iniciado por uma chamada anterior para a função InitializeSecurityContext (Geral) ou a função AcceptSecurityContext (Geral ).

Sintaxe

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY DeleteSecurityContext(
  [in] PCtxtHandle phContext
);

Parâmetros

[in] phContext

Manipular o contexto de segurança a ser excluído.

Aviso

Não use o mesmo identificador de contexto em chamadas simultâneas para DeleteSecurityContext. A implementação da API nos provedores de serviços de segurança não é thread-safe.

Retornar valor

Se a função for bem-sucedida ou o identificador já tiver sido excluído, o valor retornado será SEC_E_OK.

Se a função falhar, o valor retornado poderá ser o seguinte código de erro:

Código de retorno	Descrição
SEC_E_INVALID_HANDLE	O identificador passado para a função não é válido.

Comentários

A função DeleteSecurityContext encerra um contexto de segurança e libera recursos associados.

O chamador deve chamar essa função para um contexto de segurança quando esse contexto de segurança não for mais necessário. Isso será verdadeiro se o contexto de segurança for parcial, incompleto, rejeitado ou com falha. Depois que o contexto de segurança é excluído com êxito, o uso adicional desse contexto de segurança não é permitido e o identificador não é mais 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

AcceptSecurityContext (Geral)

InitializeSecurityContext (Geral)

Funções SSPI