Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

SmartCard.Connect

Connects to a smartcard.

Component Version macOS Windows Linux Server iOS SDK
SmartCard 6.3 ✅ Yes ✅ Yes ❌ No ✅ Yes, on macOS and Windows ❌ No
MBS( "SmartCard.Connect"; SmartCardContext; Reader; ShareMode; PreferredProtocols )   More

Parameters

Parameter Description Example
SmartCardContext The smartcard context reference number. $SmartCardContext
Reader The name of the reader that contains the target card. $reader
ShareMode A flag that indicates whether other applications may form connections to the card.
Can be integer or one of the following texts: Exclusive (1), Shared (2) or Direct (3).
"Exclusive"
PreferredProtocols A number with bitmask of acceptable protocols for the connection or just the text name of the value for only one protocol.
Pass T0 (1), T1 (2), T15 (8, not on Windows), Any (3), RAW (4).
1+2

Result

Returns OK or error.

Description

Connects to a smartcard.
Establishes a connection (using a specific resource manager context) between the calling application and a smart card contained by a specific reader. If no card exists in the specified reader, an error is returned.

On success we have a connection to a smart card.
You can query SmartCard.GetActiveProtocol

Examples

Connect

MBS( "SmartCard.Connect"; $Context; $Reader; "Shared"; "any" )

See also

Example Databases

Blog Entries

This function checks for a license.

Created 13th June 2016, last changed 3th August 2016


SmartCard.CancelTransaction - SmartCard.Control