| Components | All | New | MacOS | Windows | Linux | iOS | ||||
| Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old | |
SmartCard.GetAttribute
Retrieves the current reader attribute.
| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
| SmartCard | 6.3 | ✅ Yes | ✅ Yes | ❌ No | ✅ Yes, on macOS and Windows | ❌ No |
MBS( "SmartCard.GetAttribute"; SmartCardContext; AttributeID ) More
Parameters
| Parameter | Description | Example |
|---|---|---|
| SmartCardContext | The smartcard context reference number. | $SmartCardContext |
| AttributeID | The ID of the attribute. |
Result
Returns hex text or error.
Description
Retrieves the current reader attribute.It does not affect the state of the reader, driver, or card.
The plugin first queries for size of attribute and on success queries again to get the data and return it as a hex encoded text.
| Name | ID | Description |
| AtrString | 590595 | Answer to reset (ATR) string. |
| ChannelId | 131344 | Number encoded as 0xDDDDCCCC, where DDDD = data channel type and CCCC = channel number. |
| Characteristics | 393552 | Integer indicating which mechanical characteristics are supported. If zero, no special characteristics are supported. |
| CurrentBwt | 524809 | Current block waiting time. |
| CurrentClk | 524802 | Current clock rate, in kHz. |
| CurrentCwt | 524810 | Current character waiting time. |
| CurrentD | 524804 | Bit rate conversion factor. |
| CurrentEbcEncoding | 524811 | Current error block control encoding: 0 = longitudinal redundancy check (LRC), 1 = cyclical redundancy check (CRC) |
| CurrentF | 524803 | Clock conversion factor. |
| CurrentIfsc | 524807 | Current byte size for information field size card. |
| CurrentIfsd | 524808 | Current byte size for information field size device. |
| CurrentIoState | 590594 | Current IO state |
| CurrentN | 524805 | Current guard time. |
| CurrentProtocolType | 524801 | Integer encoded as 0x0rrrpppp where rrr is RFU and should be 0x000. pppp encodes the current protocol type. Whichever bit has been set indicates which ISO protocol is currently in use. (For example, if bit zero is set, T=0 protocol is in effect.) |
| CurrentW | 524806 | Current work waiting time. |
| DefaultClk | 196897 | Default clock rate, in kHz. |
| DefaultDataRate | 196899 | Default data rate, in bps. |
| DeviceFriendlyNameA | 2147418115 | Reader's display name. Windows ANSI encoding. |
| DeviceFriendlyNameW | 2147418117 | Reader's display name. Unicode encoding. |
| DeviceInUse | 2147418114 | Reserved for future use. |
| DeviceSystemNameA | 2147418116 | Reader's system name. Windows ANSI encoding. |
| DeviceSystemNameW | 2147418118 | Reader's system name. Unicode encoding. |
| DeviceUnit | 2147418113 | Instance of this vendor's reader attached to the computer. The first instance will be device unit 0, the next will be unit 1 (if it is the same brand of reader) and so on. Two different brands of readers will both have zero for this value. |
| EscAuthrequest | 499717 | Esc authentication request |
| EscCancel | 499715 | Esc cancel |
| EscReset | 499712 | Esc reset |
| ExtendedBwt | 524812 | Extended block wait time. |
| IccInterfaceStatus | 590593 | Single byte. Zero if smart card electrical contact is not active; nonzero if contact is active. |
| IccPresence | 590592 | 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. |
| IccTypePerAtr | 590596 | Single byte indicating smart card type: 0 = unknown type, 1 = 7816 Asynchronous, 2 = 7816 Synchronous. Other values RFU. |
| MaxClk | 196898 | Maximum clock rate, in kHz. |
| MaxDataRate | 196900 | Maximum data rate, in bps. |
| MaxIfsd | 196901 | Maximum bytes for information file size device. |
| Maxinput | 499719 | Maximum input |
| PowerMgmtSupport | 262449 | Zero if device does not support power down while smart card is inserted. Nonzero otherwise. |
| ProtocolTypes | 196896 | Integer encoded as 0x0rrrpppp where rrr is RFU and should be 0x000. pppp encodes the supported protocol types. A '1' in a given bit position indicates support for the associated ISO protocol, so if bits zero and one are set, both T=0 and T=1 protocols are supported. |
| SupressT1IfsRequest | 2147418119 | Supress T1 information file size request. |
| UserAuthInputDevice | 328002 | User authentication input device |
| UserToCardAuthDevice | 328000 | User to card authentication device |
| VendorIfdSerialNo | 65795 | Vendor-supplied interface device serial number. |
| VendorIfdType | 65793 | Vendor-supplied interface device type (model designation of reader). |
| VendorIfdVersion | 65794 | Vendor-supplied interface device version (DWORD in the form 0xMMmmbbbb where MM = major version, mm = minor version, and bbbb = build number). |
| VendorName | 65792 | Vendor name. |
See also
This function checks for a license.
Created 13th June 2016, last changed 19th June 2016
