Función SetContextAttributesW (sspi.h)

Permite a una aplicación de transporte establecer atributos de un contexto 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 SetContextAttributesW(
  [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 valores siguientes.

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 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 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 son 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 de SecPkgContext_KeyingMaterialInfo . La característica de exportación de material de clave sigue el 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 en los que se van a establecer los atributos. El tipo de estructura a la que se 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 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 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 esta función no es compatible.

Comentarios

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 Convenciones para prototipos de función.

Requisitos

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