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

SmartCard.Reconnect

Reconnects to smart card with different protocol.

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

Parameters

Parameter Description Example
SmartCardContext The smartcard context reference number. $SmartCardContext
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
Initialization Type of initialization that should be performed on the card.
Can be Leave, Reset, Unpower or Eject.
"Reset"

Result

Returns OK or error.

Description

Reconnects to smart card with different protocol.
The Reconnect function reestablishes an existing connection between the calling application and a smart card. This function moves a card handle from direct access to general access, or acknowledges and clears an error condition that is preventing further access to the card.

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

See also

This function checks for a license.

Created 13th June 2016, last changed 19th June 2016


SmartCard.ReadFile - SmartCard.Release