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.
| Return code/value | Description |
|---|---|
|
The dwFlags parameter contains a value other than zero. |
Requirements
| Minimum supported client |
Windows XP [desktop apps only] |
| Minimum supported server |
Windows Server 2003 [desktop apps only] |
| Header |
|