CardQueryKeySizes Function

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

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