Función ApplyControlToken (sspi.h)

Artículo
08/26/2023

La función ApplyControlToken proporciona una manera de aplicar un token de control a un contexto de seguridad. Se puede recibir un token cuando se establece el contexto de seguridad mediante una llamada a la función InitializeSecurityContext (Schannel) o con un servicio de seguridad por mensaje, como verify o unseal.

Esta función solo es compatible con el proveedor de compatibilidad de seguridad de Schannel (SSP).

Esta función no se admite en modo kernel.

Esta función permite aplicar tokens adicionales o de reemplazo a un contexto.

Sintaxis

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ApplyControlToken(
  [in] PCtxtHandle    phContext,
  [in] PSecBufferDesc pInput
);

Parámetros

[in] phContext

Identificador del contexto al que se aplica el token.

Para obtener información sobre la forma en que el SSP de Schannel notifica a la parte remota del apagado, consulte la sección Comentarios de DecryptMessage (Schannel). Para obtener información adicional sobre el uso de esta función, consulte Apagar una conexión Schannel.

[in] pInput

Puntero a una estructura SecBufferDesc que contiene un puntero a una estructura SecBuffer que contiene el token de entrada que se va a aplicar al contexto.

Valor devuelto

Si la función se realiza correctamente, la función devuelve SEC_E_OK.

Si se produce un error en la función, devuelve un código de error distinto de cero. El código de error siguiente es uno de los posibles códigos de error que se pueden devolver.

Código devuelto	Descripción
SEC_E_UNSUPPORTED_FUNCTION	El modo kernel de Schannel devuelve este valor para indicar que esta función no es compatible.

Comentarios

La función ApplyControlToken puede modificar el contexto en función de este token. Entre los tokens que esta función puede agregar al contexto de cliente se SCHANNEL_ALERT_TOKEN y SCHANNEL_SESSION_TOKEN.

Esta función se puede usar para apagar el contexto de seguridad que subyace a una conexión Schannel existente. Para obtener información sobre cómo hacerlo, consulte Apagar una conexión Schannel.

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