SecPkgContext_ConnectionInfo Struktur (schannel.h)

  • Artikel

Die SecPkgContext_ConnectionInfo-Struktur enthält Protokoll- und Verschlüsselungsinformationen. Diese Struktur wird von der Funktion InitializeSecurityContext (Schannel) verwendet.

Dieses Attribut wird nur vom Schannel Security Support Provider (SSP) unterstützt.

Syntax

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;

Member

dwProtocol

Protokoll, das zum Herstellen dieser Verbindung verwendet wird. In der folgenden Tabelle werden die für dieses Element gültigen Konstanten beschrieben.

Wert Bedeutung
SP_PROT_SSL2_CLIENT
8 (0x8)
 Secure Sockets Layer 2.0 clientseitig. Ersetzt durch SP_PROT_TLS1_CLIENT.
SP_PROT_SSL2_SERVER
4 (0x4)
 Secure Sockets Layer 2.0 serverseitig. Ersetzt durch SP_PROT_TLS1_SERVER.
SP_PROT_SSL3_CLIENT
32 (0x20)
 Secure Sockets Layer 3.0 clientseitig.
SP_PROT_SSL3_SERVER
16 (0x10)
 Secure Sockets Layer 3.0 serverseitig.
SP_PROT_TLS1_0_CLIENT
128 (0x80)
 Transport Layer Security 1.0 clientseitig.
SP_PROT_TLS1_0_SERVER
64 (0x40)
 Transport Layer Security 1.0 serverseitig.
SP_PROT_TLS1_1_CLIENT
512 (0x200)
 Transport Layer Security 1.1-Clientseitig.
SP_PROT_TLS1_1_SERVER
256 (0x100)
 Transport Layer Security 1.1 serverseitig.
SP_PROT_TLS1_2_CLIENT
2048 (0x800)
 Transport Layer Security 1.2 clientseitig.
SP_PROT_TLS1_2_SERVER
1024 (0x400)
 Transport Layer Security 1.2 serverseitig.
SP_PROT_TLS1_3_CLIENT
8192 (0x2000)
 Transport Layer Security 1.3 clientseitig.
SP_PROT_TLS1_3_SERVER
4096 (0x1000)
 Transport Layer Security 1.3 serverseitig.
SP_PROT_DTLS1_0_CLIENT
131072 (0x00020000)
 Datagram Transport Layer Security 1.0 clientseitig.
SP_PROT_DTLS1_0_SERVER
65536 (0x00010000)
 Datagram Transport Layer Security 1.0 serverseitig.
SP_PROT_DTLS1_2_CLIENT
524288 (0x00080000)
 Datagram Transport Layer Security 1.2 clientseitig.
SP_PROT_DTLS1_2_SERVER
262144 (0x00040000)
 Datagram Transport Layer Security 1.2 serverseitig.

aiCipher

Algorithmusbezeichner (ALG_ID) für die von dieser Verbindung verwendete Massenverschlüsselungschiffre. In der folgenden Tabelle werden die für dieses Element gültigen Konstanten beschrieben.

Wert Bedeutung
CALG_3DES
 3DES-Blockverschlüsselungsalgorithmus
CALG_AES_128
 AES 128-Bit-Verschlüsselungsalgorithmus
CALG_AES_256
 AES 256-Bit-Verschlüsselungsalgorithmus
CALG_DES
 DES-Verschlüsselungsalgorithmus
CALG_RC2
 RC2-Blockverschlüsselungsalgorithmus
CALG_RC4
 RC4-Streamverschlüsselungsalgorithmus
0 (Null)
 Keine Verschlüsselung

dwCipherStrength

Stärke der Massenverschlüsselungschiffre in Bits. Kann einer der folgenden Werte sein: 0, 40, 56, 128, 168 oder 256.

aiHash

ALG_ID den Hash an, der zum Generieren von Nachrichtenauthentifizierungscodes (Message Authentication Codes , MACs) verwendet wird. In der folgenden Tabelle werden die für dieses Element gültigen Konstanten beschrieben.

Wert Bedeutung
CALG_MD5
 MD5-Hashalgorithmus
CALG_SHA
 SHA-Hashalgorithmus

dwHashStrength

Stärke des Hashs in Bits: 128 oder 160.

aiExch

ALG_ID , der den Schlüsselaustauschalgorithmus angibt, der zum Generieren des freigegebenen Hauptgeheimnisses verwendet wird. In der folgenden Tabelle werden die für dieses Element gültigen Konstanten beschrieben.

Wert Bedeutung
ALG_TYPE_ANY
 Beliebiger Schlüsselaustauschalgorithmus.
CALG_RSA_KEYX
 RSA-Schlüsselaustausch.
CALG_DH_EPHEM
 Diffie-Hellman Schlüsselaustausch.

dwExchStrength

Schlüssellänge in Bits. Für den RSA-Schlüsselaustausch enthält dieses Element in der Regel einen der folgenden Werte: 512, 768, 1024 oder 2048. Für Diffie-Hellman Schlüsselaustausch enthält dieses Element in der Regel einen der folgenden Werte: 224, 256, 384 oder 512.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile schannel.h