CardQueryFreeSpace function

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

The CardQueryFreeSpace function, defined by a smart card module, gets the amount of available memory on a smart card.

Syntax

DWORD WINAPI CardQueryFreeSpace(
  _In_    PCARD_DATA            pCardData,
  _In_    DWORD                 dwFlags,
  _Inout_ PCARD_FREE_SPACE_INFO pCardFreeSpaceInfo
);

Parameters

pCardData [in]

A pointer to a CARD_DATA structure received from a call to the CardAcquireContext function.

dwFlags [in]

Reserved. This parameter must be set to zero.

pCardFreeSpaceInfo [in, out]

A pointer to a CARD_FREE_SPACE_INFO structure that, on output, contains information about the available memory on a smart card.

Return value

If the function succeeds, the function returns zero.

If the function fails, it returns a nonzero error value or one of the following possible error values.

Requirements

See also

Microsoft Base Smart Card Cryptographic Service Provider

CARD_DATA

CardAcquireContext