Share via

CardQueryKeySizes Function

  • Article

The CardQueryKeySizes function, defined by a smart card module, retrieves the public key lengths supported by a smart card.

Syntax

DWORD WINAPI CardQueryKeySizes(
  __in   PCARD_DATA pCardData,
  __in   DWORD dwKeySpec,
  __in   DWORD dwFlags,
  __out  PCARD_KEY_SIZES pKeySizes
);

Parameters

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

  • dwKeySpec [in]
    A DWORD value that specifies the type of the private key for which to find the length.

    This parameter can be one of the following values.

    Value Meaning
    AT_KEYEXCHANGE 1

    This function gets the sizes of keys that are used to encrypt and decrypt session keys.
    AT_SIGNATURE 2

    This function gets the sizes of keys that are used to create and verify digital signatures.

  • dwFlags [in]
    Reserved. This parameter must be set to zero.

  • pKeySizes [out]
    A pointer to a CARD_KEY_SIZES structure that, on output, contains information about the sizes of private keys supported on the smart card.

Return Value

If the function succeeds, the function returns zero.

If the function fails, it returns a nonzero 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

CARD_DATA

CARD_KEY_SIZES

CardAcquireContext

CardCreateContainer

Send comments about this topic to Microsoft

Build date: 3/5/2009