Función SetContextAttributesA (sspi.h)

Artículo
11/20/2024

Permite que una aplicación de transporte establezca atributos de un contexto de de seguridad para un paquete de seguridad . Esta función solo es compatible con el paquete de seguridad de Schannel.

Sintaxis

SECURITY_STATUS SEC_ENTRY SetContextAttributesA(
  [in] PCtxtHandle   phContext,
  [in] unsigned long ulAttribute,
  [in] void          *pBuffer,
  [in] unsigned long cbBuffer
);

Parámetros

[in] phContext

Identificador del contexto de seguridad que se va a establecer.

[in] ulAttribute

Atributo del contexto que se va a establecer. Este parámetro puede ser uno de los siguientes valores.

Valor	Significado
SECPKG_ATTR_APP_DATA 94	El parámetro pBuffer contiene un puntero a una estructura SecPkgContext_SessionAppData. Establece los datos de la aplicación para la sesión. Este atributo solo es compatible con el paquete de seguridad de Schannel.
SECPKG_ATTR_EAP_PRF_INFO 101	El parámetro pBuffer contiene un puntero a una estructura de SecPkgContext_EapPrfInfo. Establece la función pseudoaleatoria (PRF) usada por el Protocolo de autenticación extensible (EAP). Este es el valor devuelto por una llamada a la función queryContextAttributes (Schannel) cuando se pasa SECPKG_ATTR_EAP_KEY_BLOCK como valor del parámetro ulAttribute . Este atributo solo es compatible con el paquete de seguridad de Schannel.
SECPKG_ATTR_EARLY_START 105	El parámetro pBuffer contiene un puntero a una estructura SecPkgContext_EarlyStart. Establece la característica De inicio falso. Consulte la entrada de blog Building a faster and more secure web (Creación de una web más rápida y segura) para obtener información sobre esta característica.
SECPKG_ATTR_DTLS_MTU 34	Establece y recupera el valor de MTU (unidad de transmisión máxima) para su uso con DTLS. Si DTLS no está habilitado en un contexto de seguridad, no se admite este atributo. Los valores válidos están entre 200 bytes y 64 kilobytes. El valor predeterminado de MTU de DTLS en Schannel es de 1096 bytes.
SECPKG_ATTR_KEYING_MATERIAL_INFO 106	El parámetro pBuffer contiene un puntero a una estructura SecPkgContext_KeyingMaterialInfo. La característica de exportación de material de clave sigue la estándar RFC 5705. Este atributo solo es compatible con el paquete de seguridad de Schannel en Windows 10 y Windows Server 2016 o versiones posteriores.

[in] pBuffer

Puntero a una estructura que contiene valores para establecer los atributos en. El tipo de estructura al que apunta depende del valor especificado en el parámetro ulAttribute .

[in] cbBuffer

Tamaño, en bytes, del parámetro pBuffer.

Valor devuelto

Si la función se ejecuta 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 siguiente código de error es uno de los posibles códigos de error.

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

Observaciones

Nota

El encabezado sspi.h define SetContextAttributes como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	sspi.h (include Security.h)
biblioteca de	Secur32.lib
DLL de	Secur32.dll

Compartir a través de