96 lines
2.6 KiB
Plaintext
96 lines
2.6 KiB
Plaintext
List of SCardGetAttrib() commands supported by the CCID driver
|
|
==============================================================
|
|
|
|
PC/SC provides the SCardGetAttrib() function to request some attributes from
|
|
the driver.
|
|
|
|
|
|
PC/SC function prototype
|
|
"""""""""""""""""""""""""
|
|
|
|
LONG SCardGetAttrib(SCARDHANDLE hCard,
|
|
DWORD dwAttrId,
|
|
LPBYTE pbAttr,
|
|
LPDWORD pcbAttrLen);
|
|
|
|
Parameters:
|
|
|
|
hCard IN Connection made from SCardConnect
|
|
dwAttrId IN Identifier for the attribute to get
|
|
pbAttr OUT Pointer to a buffer that receives the attribute
|
|
pcbAttrLen IN/OUT Length of the pbAttr buffer in bytes
|
|
|
|
If the attribute is not supported the applications receive the error
|
|
SCARD_E_UNSUPPORTED_FEATURE (or SCARD_E_NOT_TRANSACTED for pcsc-lite
|
|
version < 1.3.3)
|
|
|
|
|
|
supported attributes
|
|
""""""""""""""""""""
|
|
|
|
SCARD_ATTR_ATR_STRING
|
|
ATR of the card
|
|
|
|
SCARD_ATTR_ICC_INTERFACE_STATUS
|
|
Single byte. Zero if smart card electrical contact is not active;
|
|
nonzero if contact is active.
|
|
|
|
SCARD_ATTR_ICC_PRESENCE
|
|
Single byte indicating smart card presence:
|
|
0 = not present
|
|
1 = card present but not swallowed (applies only if reader supports
|
|
smart card swallowing)
|
|
2 = card present (and swallowed if reader supports smart card swallowing)
|
|
4 = card confiscated.
|
|
|
|
SCARD_ATTR_VENDOR_IFD_VERSION
|
|
Vendor-supplied interface device version
|
|
DWORD in the form 0xMMmmbbbb where
|
|
MM = major version,
|
|
mm = minor version,
|
|
and bbbb = build number
|
|
It is the bcdDevice USB field.
|
|
|
|
SCARD_ATTR_VENDOR_NAME
|
|
name of the IFD (reader) vendor. It is the iManufacturer USB field
|
|
(if any).
|
|
|
|
SCARD_ATTR_MAXINPUT
|
|
maximum size of an APDU supported by the reader.
|
|
format is unsigned 32-bit unsing the byte order of the platform.
|
|
Correct readers should support up to 261 bytes (CLA + INS + P1 + P2 +
|
|
Lc + 255 bytes of data) but some readers support less (253 bytes only
|
|
for example). It is a problem for T=1 cards when the reader works in
|
|
APDU mode instead of TPDU and for T=0 cards.
|
|
|
|
SCARD_ATTR_VENDOR_IFD_SERIAL_NO
|
|
reader serial number (if available).
|
|
|
|
|
|
Sample code
|
|
===========
|
|
|
|
#include <reader.h>
|
|
|
|
{
|
|
[...]
|
|
|
|
unsigned char pbAtr[MAX_ATR_SIZE];
|
|
DWORD dwAtrLen;
|
|
|
|
/* use a NULL buffer to just get the needed length */
|
|
rv = SCardGetAttrib(hCard, SCARD_ATTR_ATR_STRING, NULL, &dwAtrLen);
|
|
if (rv == SCARD_S_SUCCESS)
|
|
printf("ATR length: %ld\n", dwAtrLen);
|
|
|
|
dwAtrLen = sizeof(pbAtr);
|
|
rv = SCardGetAttrib(hCard, SCARD_ATTR_ATR_STRING, pbAtr, &dwAtrLen);
|
|
if (rv == SCARD_S_SUCCESS)
|
|
{
|
|
for (i = 0; i < dwAtrLen; i++)
|
|
printf("%02X ", pbAtr[i]);
|
|
printf("\n");
|
|
}
|
|
}
|
|
|