Función DeleteSecurityContext (sspi.h)

La función DeleteSecurityContext elimina las estructuras de datos locales asociadas al contexto de seguridad especificado iniciado por una llamada anterior a la función InitializeSecurityContext (General) o a la función AcceptSecurityContext (General).

Sintaxis

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY DeleteSecurityContext(
  [in] PCtxtHandle phContext
);

Parámetros

[in] phContext

Identificador del contexto de seguridad que se va a eliminar.

Advertencia

No use el mismo identificador de contexto en llamadas simultáneas a DeleteSecurityContext. La implementación de api en los proveedores de servicios de seguridad no es segura para subprocesos.

Valor devuelto

Si la función se ejecuta correctamente o el identificador ya se ha eliminado, el valor devuelto es SEC_E_OK.

Si se produce un error en la función, el valor devuelto puede ser el siguiente código de error:

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

Comentarios

La función DeleteSecurityContext 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 así 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 XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	sspi.h (include Security.h)
Library	Secur32.lib
Archivo DLL	Secur32.dll

Consulte también

AcceptSecurityContext (General)

InitializeSecurityContext (General)

Funciones SSPI