Función SspiDeleteSecurityContextAsync (sspi.h)

Artículo
03/13/2024

La función SspiDeleteSecurityContextAsync elimina las estructuras de datos locales asociadas al contexto de seguridad especificado iniciado por una llamada anterior a la función SspiInitializeSecurityContextAsync o a la función SspiAcceptSecurityContextAsync .

Sintaxis

SECURITY_STATUS SspiDeleteSecurityContextAsync(
  SspiAsyncContext *AsyncContext,
  PCtxtHandle      phContext
);

Parámetros

AsyncContext

Contexto de llamada asincrónica.

phContext

Identificador del contexto de seguridad que se va a eliminar.

Valor devuelto

Devuelve SEC_E_OK si la solicitud asincrónica para eliminar el contexto de seguridad se puso en cola correctamente para su ejecución. De lo contrario, devuelve el error generado al intentar ponerla en cola. Para recuperar el estado de la operación, use SspiGetAsyncCallStatus.

SspiGetAsyncCallStatus devuelve SEC_E_OK al finalizar. De lo contrario, puede devolver SEC_I_ASYNC_CALL_PENDING si la llamada sigue en curso o uno de los códigos de error siguientes.

Código devuelto	Descripción
SEC_E_INVALID_HANDLE	El identificador pasado a la función no es válido.

Comentarios

En la finalización de llamadas asincrónicas, los autores de llamadas pueden optar por no recibir una notificación evitando establecer una devolución de llamada para un nuevo SspiAsyncContext o quitando la devolución de llamada mediante SspiSetAsyncNotifyCallback con un parámetro NULL. Si opta por no participar, el autor de la llamada debe liberar el contexto con SspiFreeAsyncContext inmediatamente después de llamar a SspiDeleteSecurityContextAsync, a menos que el contexto esté pensado para su reutilización.

La función SspiDeleteSecurityContextAsync finaliza un contexto de seguridad y libera los recursos asociados.

El autor de la llamada debe llamar a esta función para un contexto de seguridad cuando ese contexto de seguridad ya no es necesario. Esto es cierto si el contexto de seguridad es parcial, incompleto, rechazado o erróneo. Una vez eliminado correctamente el contexto de seguridad, no se permite el uso adicional de ese contexto de seguridad y el identificador ya no es válido.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1607 [solo controladores en modo kernel]
Servidor mínimo compatible	Windows Server 2016 [solo controladores en modo kernel]
Encabezado	sspi.h