CARD_DH_AGREEMENT_INFO structure

This topic is not current. For the most current information about the Smart Card API, see Smart Card Minidriver Specification.

The CARD_DH_AGREEMENT_INFO structure specifies information necessary for the CardConstructDHAgreement function to calculate a Diffie-Hellman key exchange secret agreement.

Windows Server 2003, Windows XP, Windows 2000 Server and Windows 2000 Professional: Diffie-Hellman key exchange secret calculation is not supported.

Syntax

typedef struct _CARD_DH_AGREEMENT_INFO {
  DWORD dwVersion;
  BYTE  bContainerIndex;
  DWORD dwFlags;
  DWORD dwPublicKey;
  PBYTE pbPublicKey;
  PBYTE pbReserved;
  DWORD cbReserved;
  BYTE  bSecretAgreementIndex;
} CARD_DH_AGREEMENT_INFO, *PCARD_DH_AGREEMENT_INFO;

Members

dwVersion

The version of this structure, to be set by the caller. The current version is 2.

bContainerIndex

The key container index number. The container holds the keys that perform the calculation.

dwFlags

Reserved. You must set this member to zero.

dwPublicKey

The size, in bytes, of the pbPublicKey buffer.

pbPublicKey

A pointer to a buffer that specifies the public key. The CardConstructDHAgreement function constructs the agreement from this key.

pbReserved

Reserved.

cbReserved

Reserved.

bSecretAgreementIndex

The index of the container that holds the secret agreement on successful completion of the CardConstructDHAgreement function.

Requirements

Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Cardmod.h

See also

Microsoft Base Smart Card Cryptographic Service Provider