Função SspiDeleteSecurityContextAsync (sspi.h)
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 |
Confira também
SspiAcceptSecurityContextAsync