SecPkgContext_ConnectionInfo

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure contains protocol and cipher information. It is used by the QueryContextAttributes function.

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
  Specifies the protocol used to establish this connection. The following table shows valid constants for this member.

  Value	Description
  SP_PROT_TLS1_CLIENT	Transport Layer Security 1.0 client-side.
  SP_PROT_TLS1_SERVER	Transport Layer Security 1.0 server-side.
  SP_PROT_SSL3_CLIENT	Secure Sockets Layer 3.0 client-side.
  SP_PROT_SSL3_SERVER	Secure Sockets Layer 3.0 server-side.
  SP_PROT_SSL2_CLIENT	Secure Sockets Layer 2.0 client-side. Superseded by SP_PROT_TLS1_CLIENT.
  SP_PROT_SSL2_SERVER	Secure Sockets Layer 2.0 server-side. Superseded by SP_PROT_TLS1_SERVER.

• aiCipher
  Algorithm identifier (ALG_ID) for the bulk encryption cipher used by this connection. The following table shows the valid constants for this member.

  Value	Description
  CALG_RC2	RC2 block encryption algorithm.
  CALG_RC4	RC4 stream encryption algorithm.
  CALG_DES	DES encryption algorithm.
  CALG_SKIPJACK	Skipjackblock encryption algorithm (FORTEZZA).
  0 (Zero)	No encryption.

• dwCipherStrength
  Specifies the strength of the bulk encryption cipher, in bits. Can be one of the following values: 0, 40, 56, 80, 128, or 168.

• aiHash
  ALG_ID indicating the hash used for generating message authentication codes (MACs). The following table describes the valid constants for this member.

  Value	Description
  CALG_MD5	MD5 hashing algorithm.
  CALG_SHA	SHA hashing algorithm.

• dwHashStrength
  Specifies the 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 valid constants for this member.

  Value	Description
  CALG_RSA_KEYX	RSA key exchange.
  CALG_DH_EPHEM	Diffie-Hellman (DH) key exchange.
  CALG_EXCH_KEA	FORTEZZA.

• dwExchStrength
  Specifies the strength of the key exchange, in bits. Typically, this member contains one of the following values: 512, 768, 1024, or 2048.

Requirements

See Also

Reference

QueryContextAttributes