SecPkgContext_ConnectionInfo (Compact 7)

3/12/2014

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
    Designates 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
    Designates 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
    Designates 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
    Designates the strength of the key exchange, in bits. Typically, this member contains one of the following values: 512, 768, 1024, or 2048.

Note

Although the RC2/40 algorithm is included in Windows Embedded CE 7, it will not be supported in later versions. Until then, it can be used in CE operating systems for legacy purposes, except it was removed from the S/MIME feature.

Requirements

Header

schnlsp.h

See Also

Reference

Authentication Services Structures
QueryContextAttributes