SmartcardUpdateCardCapabilities (Windows CE 5.0)
The SmartcardUpdateCardCapabilities function translates an ATR string into the SCARD_CARD_CAPABILITIES structure that can be used by the driver.
NTSTATUS SmartcardUpdateCardCapabilities(PSMARTCARD_EXTENSION SmartcardExtension);
Parameters
- SmartcardExtension
[in] Points to the smart card extension of the device.
Return Values
SmartcardUpdateCardCapabilities returns an NTSTATUS value. Possible values are the following.
| Value | Description |
|---|---|
| STATUS_SUCCESS | ATR successfully translated. |
| STATUS_UNRECOGNIZED_MEDIA | The ATR neither starts with 0x3B nor 0x3F. It is also possible that the ATR contains non-ISO-conforming values for Fl or Dl, or the ATR checksum for T=1 is wrong. |
Remarks
This function should be called by the driver just after the driver has read the ATR into the ATR member of the SCARD_CARD_CAPABILITIES structure. The ATR bytes must be stored in Buffer, and Length must be adjusted to the actual length of the ATR returned by the card.
This function can handle only T=0 and T=1 cards.
The function converts the ATR string into the values defined by ISO 7816-3. These values are all stored in the SCARD_CARD_CAPABILITIES structure. All time values in that structure are in microseconds, not in seconds.
Requirements
OS Versions: Windows CE 3.0 and later.
Header: Smclib.h.
See Also
Send Feedback on this topic to the authors