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)