Share via

SCardDisconnect

  • Article

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

LONG SCardDisconnect(
  SCARDHANDLE hCard, 
  DWORD dwDisposition 
);

Parameters

  • hCard
    [in] Handle to the reference value obtained from a previous call to SCardConnect.
  • dwDisposition
    [in] Specifies what to do with the card in the connected reader on close. The following table 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

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

SCardDisconnect 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 | SCardReconnect

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.