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 指出用來產生共用主要密碼的 密鑰交換演算法 。 下表描述此成員的有效常數。

值 意義
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