PC/SC Guide
Prox–DU & Prox–SU
www.gemalto.com
DOC119811A Public Use Page 68/129
SCardGetAttrib Function
The SCardGetAttrib function retrieves the current reader attributes for the given handle. It
does not affect the state of the reader, driver, or card.
Syntax:
LONG WINAPI SCardGetAttrib(
__in SCARDHANDLE hCard,
__in DWORD dwAttrId,
__out LPBYTE pbAttr,
__inout LPDWORD pcbAttrLen
);
Parameters:
hCard [in]
Reference value returned from SCardConnect.
dwAttrId [in]
Identifier for the attribute to get. The following table lists possible values for
dwAttrId. These values are read-only. Note that vendors may not support all
attributes:
SCARD_ATTR_ATR_STRING: Answer to reset (ATR) string.
SCARD_ATTR_CHANNEL_ID: DWORD encoded as 0xDDDDCCCC, where
DDDD = data channel type and CCCC = channel number:
The following encodings are defined for DDDD:
0x01 serial I/O; CCCC is a port number.
0x02 parallel I/O; CCCC is a port number.
0x04 PS/2 keyboard port; CCCC is zero.
0x08 SCSI; CCCC is SCSI ID number.
0x10 IDE; CCCC is device number.
0x20 USB; CCCC is device number.
0xFy vendor-defined interface with y in the range zero through 15; CCCC is
vendor defined.
SCARD_ATTR_CHARACTERISTICS: DWORD indicating which mechanical
characteristics are supported. If zero, no special characteristics are supported. Note
that multiple bits can be set:
0x00000001 Card swallowing mechanism
0x00000002 Card ejection mechanism
0x00000004 Card capture mechanism
All other values are reserved for future use (RFU).
SCARD_ATTR_CURRENT_BWT: Current block waiting time.
SCARD_ATTR_CURRENT_CLK: Current clock rate, in kHz.
SCARD_ATTR_CURRENT_CWT: Current character waiting time.
SCARD_ATTR_CURRENT_D: Bit rate conversion factor.