SCardDisconnect

This function terminates a connection previously opened between the calling application and a smart card in the target reader.

LONG SCardDisconnect(
IN SCARDHANDLE hCard, 
IN DWORD dwDisposition );

Parameters

  • hCard
    Handle to the reference value obtained from a previous call to SCardConnect.
  • dwDisposition
    Specifies what to do with the card in the connected reader on close. The following list shows the possible values for dwDisposition.
    Value Description
    SCARD_LEAVE_CARD Do nothing.
    SCARD_RESET_CARD Reset the card.
    SCARD_UNPOWER_CARD Power down the card.
    SCARD_EJECT_CARD Eject the card.

Return Values

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

Remarks

SCardDisconnect is a smart card and reader access function.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 3.0 and later Winscard.h   Winscard.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

SCardConnect, SCardReconnect

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.