Função SspiDeleteSecurityContextAsync (sspi.h)

Artigo
08/26/2023

A função SspiDeleteSecurityContextAsync exclui as estruturas de dados locais associadas ao contexto de segurança especificado iniciado por uma chamada anterior para a função SspiInitializeSecurityContextAsync ou a função SspiAcceptSecurityContextAsync .

Sintaxe

SECURITY_STATUS SspiDeleteSecurityContextAsync(
  SspiAsyncContext *AsyncContext,
  PCtxtHandle      phContext
);

Parâmetros

AsyncContext

O contexto de chamada assíncrona.

phContext

Identificador do contexto de segurança a ser excluído.

Retornar valor

Retorna SEC_E_OK se a solicitação assíncrona para excluir o contexto de segurança foi enfileirada com êxito para execução. Caso contrário, ele retornará o erro gerado ao tentar enfileirar. Para recuperar o status da operação, use SspiGetAsyncCallStatus.

SspiGetAsyncCallStatus retorna SEC_E_OK após a conclusão. Caso contrário, ele poderá retornar SEC_I_ASYNC_CALL_PENDING se a chamada ainda estiver em andamento ou um dos códigos de erro abaixo.

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

Comentários

Na conclusão da chamada assíncrona, os chamadores podem optar por não receber uma notificação evitando a configuração de um retorno de chamada para um novo SspiAsyncContext ou removendo o retorno de chamada usando SspiSetAsyncNotifyCallback com um parâmetro nulo. Se recusar, o chamador deverá liberar o contexto com SspiFreeAsyncContext imediatamente após chamar SspiDeleteSecurityContextAsync, a menos que o contexto se destine à reutilização.

A função SspiDeleteSecurityContextAsync 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 10, versão 1607 [somente drivers no modo kernel]
Servidor mínimo com suporte	Windows Server 2016 [somente drivers no modo kernel]
Cabeçalho	sspi.h