Microsoft Windows CE 3.0  

SmartcardUpdateCardCapabilities

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

The SmartcardUpdateCardCapabilities function translates an ATR string into the SCARD_CARD_CAPABILITIESstructure that can be used by the driver.

NTSTATUS SmartcardUpdateCardCapabilities(
PSMARTCARD_EXTENSION
SmartcardExtension
);

Parameters

SmartcardExtension
Points to the smart card extension of the device.

Return Values

SmartcardUpdateCardCapabilities returns an NTSTATUS value. Possible values are the following.

Value Meaning
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 ATRmember of the SCARD_CARD_CAPABILITIESstructure. The ATR bytes must be stored in Buffer, and Lengthmust be adjusted to the actual length of the ATR returned by the card.

This function can handle only T=0 and T=1 cards.

// // Answer To Reset string returned by card. //
struct { UCHAR Buffer[64]; UCHAR Length; } ATR;

The function converts the ATR string into the values defined by ISO 7816-3. These values are all stored in the SCARD_CARD_CAPABILITIESstructure. All time values in that structure are in microseconds, not in seconds.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 3.0 and later      
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.


 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.