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 |