SCardDisconnect

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

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 Value

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

Header winscard.h
Library winscard.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

SCardConnect
SCardReconnect