estructura SecPkgContext_ConnectionInfo (schannel.h)

  • Artículo

La estructura SecPkgContext_ConnectionInfo contiene información de protocolo y cifrado. Esta estructura la usa la función InitializeSecurityContext (Schannel).

Este atributo solo es compatible con el proveedor de compatibilidad de seguridad (SSP) de Schannel.

Sintaxis

typedef struct _SecPkgContext_ConnectionInfo {
  DWORD  dwProtocol;
  ALG_ID aiCipher;
  DWORD  dwCipherStrength;
  ALG_ID aiHash;
  DWORD  dwHashStrength;
  ALG_ID aiExch;
  DWORD  dwExchStrength;
} SecPkgContext_ConnectionInfo, *PSecPkgContext_ConnectionInfo;

Miembros

dwProtocol

Protocolo utilizado para establecer esta conexión. En la tabla siguiente se describen las constantes válidas para este miembro.

Valor Significado
SP_PROT_SSL2_CLIENT
8 (0x8)
 Capa de sockets seguros 2.0 del lado cliente. Reemplazado por SP_PROT_TLS1_CLIENT.
SP_PROT_SSL2_SERVER
4 (0x4)
 Capa de sockets seguros 2.0 del lado servidor. Reemplazado por SP_PROT_TLS1_SERVER.
SP_PROT_SSL3_CLIENT
32 (0x20)
 Capa de sockets seguros 3.0 del lado cliente.
SP_PROT_SSL3_SERVER
16 (0x10)
 Capa de sockets seguros 3.0 del lado servidor.
SP_PROT_TLS1_0_CLIENT
128 (0x80)
 Seguridad de la capa de transporte 1.0 del lado cliente.
SP_PROT_TLS1_0_SERVER
64 (0x40)
 Seguridad de la capa de transporte 1.0 del lado servidor.
SP_PROT_TLS1_1_CLIENT
512 (0x200)
 Seguridad de la capa de transporte 1.1 del lado cliente.
SP_PROT_TLS1_1_SERVER
256 (0x100)
 Seguridad de la capa de transporte 1.1 del lado servidor.
SP_PROT_TLS1_2_CLIENT
2048 (0x800)
 Seguridad de la capa de transporte 1.2 del lado cliente.
SP_PROT_TLS1_2_SERVER
1024 (0x400)
 Seguridad de la capa de transporte 1.2 del lado servidor.
SP_PROT_TLS1_3_CLIENT
8192 (0x2000)
 Seguridad de la capa de transporte 1.3 del lado cliente.
SP_PROT_TLS1_3_SERVER
4096 (0x1000)
 Seguridad de la capa de transporte 1.3 del lado servidor.
SP_PROT_DTLS1_0_CLIENT
131072 (0x00020000)
 Seguridad de la capa de transporte de datagramas 1.0 del lado cliente.
SP_PROT_DTLS1_0_SERVER
65536 (0x00010000)
 Seguridad de la capa de transporte de datagramas 1.0 del lado servidor.
SP_PROT_DTLS1_2_CLIENT
524288 (0x00080000)
 Seguridad de la capa de transporte de datagramas 1.2 del lado cliente.
SP_PROT_DTLS1_2_SERVER
262144 (0x00040000)
 Seguridad de la capa de transporte de datagramas 1.2 del lado servidor.

aiCipher

Identificador de algoritmo (ALG_ID) para el cifrado de cifrado masivo usado por esta conexión. En la tabla siguiente se describen las constantes válidas para este miembro.

Valor Significado
CALG_3DES
 Algoritmo de cifrado de bloques 3DES
CALG_AES_128
 Algoritmo de cifrado AES de 128 bits
CALG_AES_256
 Algoritmo de cifrado AES de 256 bits
CALG_DES
 Algoritmo de cifrado DES
CALG_RC2
 Algoritmo de cifrado de bloques RC2
CALG_RC4
 Algoritmo de cifrado de flujo RC4
0 (cero)
 Sin cifrado

dwCipherStrength

Intensidad del cifrado masivo, en bits. Puede ser uno de los siguientes valores: 0, 40, 56, 128, 168 o 256.

aiHash

ALG_ID que indica el hash usado para generar códigos de autenticación de mensajes (MAC). En la tabla siguiente se describen las constantes válidas para este miembro.

Valor Significado
CALG_MD5
 Algoritmo de hash MD5.
CALG_SHA
 Algoritmo de hash SHA.

dwHashStrength

Intensidad del hash, en bits: 128 o 160.

aiExch

ALG_ID que indica el algoritmo de intercambio de claves usado para generar el secreto maestro compartido. En la tabla siguiente se describen las constantes válidas para este miembro.

Valor Significado
CALG_RSA_KEYX
 Intercambio de claves RSA.
CALG_DH_EPHEM
 Diffie-Hellman intercambio de claves.

dwExchStrength

Longitud de clave, en bits. Para el intercambio de claves RSA, este miembro normalmente contendrá uno de los siguientes valores: 512, 768, 1024 o 2048. Para Diffie-Hellman intercambio de claves, este miembro normalmente contendrá uno de los valores siguientes: 224, 256, 384 o 512.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado schannel.h