SecPkgContext_ConnectionInfo 结构 (schannel.h)

SecPkgContext_ConnectionInfo结构包含协议和密码信息。 InitializeSecurityContext (Schannel) 函数使用此结构。

仅 Schannel 安全支持提供程序 (SSP) 支持此属性。

语法

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;

成员

dwProtocol

用于建立此连接的协议。 下表描述了对此成员有效的常量。

含义
SP_PROT_SSL2_CLIENT
8 (0x8)
安全套接字第 2.0 层客户端。 被SP_PROT_TLS1_CLIENT取代。
SP_PROT_SSL2_SERVER
4 (0x4)
安全套接字第 2.0 层服务器端。 被SP_PROT_TLS1_SERVER取代。
SP_PROT_SSL3_CLIENT
32 (0x20)
安全套接字第 3.0 层客户端。
SP_PROT_SSL3_SERVER
16 (0x10)
安全套接字第 3.0 层服务器端。
SP_PROT_TLS1_0_CLIENT
128 (0x80)
传输层安全性 1.0 客户端。
SP_PROT_TLS1_0_SERVER
64 (0x40)
传输层安全性 1.0 服务器端。
SP_PROT_TLS1_1_CLIENT
512 (0x200)
传输层安全性 1.1 客户端。
SP_PROT_TLS1_1_SERVER
256 (0x100)
传输层安全性 1.1 服务器端。
SP_PROT_TLS1_2_CLIENT
2048 (0x800)
传输层安全性 1.2 客户端。
SP_PROT_TLS1_2_SERVER
1024 (0x400)
传输层安全性 1.2 服务器端。
SP_PROT_TLS1_3_CLIENT
8192 (0x2000)
传输层安全性 1.3 客户端。
SP_PROT_TLS1_3_SERVER
4096 (0x1000)
传输层安全性 1.3 服务器端。
SP_PROT_DTLS1_0_CLIENT
131072 (0x00020000)
数据报传输层安全性 1.0 客户端。
SP_PROT_DTLS1_0_SERVER
65536 (0x00010000)
数据报传输层安全性 1.0 服务器端。
SP_PROT_DTLS1_2_CLIENT
524288 (0x00080000)
数据报传输层安全性 1.2 客户端。
SP_PROT_DTLS1_2_SERVER
262144 (0x00040000)
数据报传输层安全性 1.2 服务器端。

aiCipher

此连接使用的批量加密密码的算法标识符 ( ALG_ID) 。 下表描述了对此成员有效的常量。

含义
CALG_3DES
3DES 块加密算法
CALG_AES_128
AES 128 位加密算法
CALG_AES_256
AES 256 位加密算法
CALG_DES
DES 加密算法
CALG_RC2
RC2 块加密算法
CALG_RC4
RC4 流加密算法
0 (零)
无加密

dwCipherStrength

批量加密密码的强度(以位为单位)。 可以是以下值之一:0、40、56、128、168 或 256。

aiHash

ALG_ID指示用于 (MAC) 生成消息身份验证代码哈希。 下表描述了对此成员有效的常量。

含义
CALG_MD5
MD5 哈希算法。
CALG_SHA
SHA 哈希算法。

dwHashStrength

哈希的强度(以位为单位):128 或 160。

aiExch

ALG_ID 指示用于生成共享主密钥的 密钥交换算法 。 下表描述了对此成员有效的常量。

含义
ALG_TYPE_ANY
任何密钥交换算法。
CALG_RSA_KEYX
RSA 密钥交换。
CALG_DH_EPHEM
Diffie-Hellman 密钥交换。

dwExchStrength

密钥长度(以位为单位)。 对于 RSA 密钥交换,此成员通常包含以下值之一:512、768、1024 或 2048。 对于 Diffie-Hellman 密钥交换,此成员通常包含以下值之一:224、256、384 或 512。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 schannel.h