SecPkgContext_ConnectionInfo structure (schannel.h)
The SecPkgContext_ConnectionInfo structure contains protocol and cipher information. This structure is used by the InitializeSecurityContext (Schannel) function.
This attribute is supported only by the Schannel security support provider (SSP).
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;
Members
dwProtocol
Protocol used to establish this connection. The following table describes the constants valid for this member.
Value | Meaning |
---|---|
|
Secure Sockets Layer 2.0 client-side. Superseded by SP_PROT_TLS1_CLIENT. |
|
Secure Sockets Layer 2.0 server-side. Superseded by SP_PROT_TLS1_SERVER. |
|
Secure Sockets Layer 3.0 client-side. |
|
Secure Sockets Layer 3.0 server-side. |
|
Transport Layer Security 1.0 client-side. |
|
Transport Layer Security 1.0 server-side. |
|
Transport Layer Security 1.1 client-side. |
|
Transport Layer Security 1.1 server-side. |
|
Transport Layer Security 1.2 client-side. |
|
Transport Layer Security 1.2 server-side. |
|
Transport Layer Security 1.3 client-side. |
|
Transport Layer Security 1.3 server-side. |
|
Datagram Transport Layer Security 1.0 client-side. |
|
Datagram Transport Layer Security 1.0 server-side. |
|
Datagram Transport Layer Security 1.2 client-side. |
|
Datagram Transport Layer Security 1.2 server-side. |
aiCipher
Algorithm identifier (ALG_ID) for the bulk encryption cipher used by this connection. The following table describes the constants valid for this member.
dwCipherStrength
Strength of the bulk encryption cipher, in bits. Can be one of the following values: 0, 40, 56, 128, 168, or 256.
aiHash
ALG_ID indicating the hash used for generating Message Authentication Codes (MACs). The following table describes the constants valid for this member.
Value | Meaning |
---|---|
|
MD5 hashing algorithm. |
|
SHA hashing algorithm. |
dwHashStrength
Strength of the hash, in bits: 128 or 160.
aiExch
ALG_ID indicating the key exchange algorithm used to generate the shared master secret. The following table describes the constants valid for this member.
Value | Meaning |
---|---|
|
Any key exchange algorithm. |
|
RSA key exchange. |
|
Diffie-Hellman key exchange. |
dwExchStrength
Key length, in bits. For RSA key exchange, this member will typically contain one of the following values: 512, 768, 1024, or 2048. For Diffie-Hellman key exchange, this member will typically contain one of the following values: 224, 256, 384 or 512.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Header | schannel.h |