PC/SC Guide
Prox–DU & Prox–SU
www.gemalto.com
DOC119811A Public Use Page 53/129
SCardReconnect Function
The SCardReconnect 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.
Syntax:
LONG WINAPI SCardReconnect(
__in SCARDHANDLE hCard,
__in DWORD dwShareMode,
__in DWORD dwPreferredProtocols,
__in DWORD dwInitialization,
__out_opt LPDWORD pdwActiveProtocol
);
Parameters:
hCard [in]
Reference value obtained from a previous call to SCardConnect.
dwShareMode [in]
Flag that indicates whether other applications may form connections to this card:
SCARD_SHARE_SHARED: This application will share this card with other
applications.
SCARD_SHARE_EXCLUSIVE: This application will not share this card with other
applications.
dwPreferredProtocols [in]
Bitmask of acceptable protocols for this connection. Possible values may be
combined with the OR operation. The value of this parameter should include the
current protocol. Attempting to reconnect with a protocol other than the current
protocol will result in an error.
SCARD_PROTOCOL_T0: T=0 is an acceptable protocol.
SCARD_PROTOCOL_T1: T=1 is an acceptable protocol.
dwInitialization [in]
Type of initialization that should be performed on the card:
SCARD_LEAVE_CARD: Do not do anything special on reconnect.
SCARD_RESET_CARD: Reset the card (Warm Reset).
SCARD_UNPOWER_CARD: Power down the card and reset it (Cold Reset).
pdwActiveProtocol [out, optional]
Flag that indicates the established active protocol:
SCARD_PROTOCOL_T0: T=0 is the active protocol.
SCARD_PROTOCOL_T1: T=1 is the active protocol.
Return Value:
This function returns different values depending on whether it succeeds or fails.
To Next Page
Loading...
