SCardReconnect (Windows CE 5.0)

  • Article

Send Feedback

This function re-establishes an existing connection between the calling application and a smart card. The 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.

LONG SCardReconnect(SCARDHANDLEhCard, DWORDdwShareMode, DWORDdwPreferredProtocols, DWORDdwInitialization, LPDWORDpdwActiveProtocol);

Parameters

  • hCard
    [in] Handle to the reference value obtained from a previous call to SCardConnect.
  • dwShareMode
    [in] Specifies a flag that indicates whether other applications can form connections to this card. The following table shows the possible values for dwShareMode.
    Value Description
    SCARD_SHARE_SHARED This application will share the card with other applications.
    SCARD_SHARE_EXCLUSIVE This application will not share this card with other applications.
  • dwPreferredProtocols
    [in] Supplies a bit mask of acceptable protocols for this connection. The following table shows the possible values, which may be combined with the OR operation, for dwPreferredProtocols.
    Value Description
    SCARD_PROTOCOL_T0 T=0 is an acceptable protocol.
    SCARD_PROTOCOL_T1 T=1 is an acceptable protocol.
  • dwInitialization
    [in] Specifies the kind of initialization to perform on the card. The following table shows the possible values for dwInitialization.
    Value Description
    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] Pointer that specifies a flag indicating the established active protocol. The following table shows the possible values for pdwActiveProtocol.
    Value Description
    SCARD_PROTOCOL_T0 T=0 is the active protocol.
    SCARD_PROTOCOL_T1 T=1 is the active protocol.

Return Values

The following table shows the possible return values.

Value Description
SCARD_S_SUCCESS Succeeds
An error value (see Smart Card Error Values for a list of all error values). Fails

Remarks

SCardReconnect is a smart card and reader access function.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Winscard.h.
Link Library: Winscard.lib.

See Also

SCardConnect | SCardDisconnect

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.