Compartilhar via


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