Share via


CardConstructDHAgreement Function

The CardConstructDHAgreement function, defined by a smart card module, performs a secret agreement calculation for Diffie-Hellman key exchange by using the specified private key.

**Windows Server 2003, Windows XP, Windows 2000 Server, and Windows 2000 Professional:  **This function is not supported.

Syntax

DWORD WINAPI CardConstructDHAgreement(
  __in  PCARD_DATA pCardData,
  __in  PCARD_DH_AGREEMENT_INFO pAgreementInfo
);

Parameters

  • pCardData [in]
    A pointer to the CARD_DATA structure received from a call to the CardAcquireContext function.

  • pAgreementInfo [in]
    A pointer to a CARD_DH_AGREEMENT_INFO structure that, on input, specifies the index of the container that contains the keys to exchange. On output, the structure contains a handle to the calculated secret agreement.

Return Value

If the function succeeds, it returns zero.

If the function fails, it returns a nonzero error value.

Requirements

Minimum supported client Windows XP, Windows 2000 Professional with SP4
Minimum supported server Windows Server 2003, Windows 2000 Server with SP4
Header Cardmod.h

See Also

Microsoft Base Smart Card Cryptographic Service Provider

Send comments about this topic to Microsoft

Build date: 3/5/2009