ISCard::ReAttach

The ReAttach method resets, or reinitializes, the smart card.

HRESULT ReAttach(
  SCARD_SHARE_MODES ShareMode,  
  SCARD_DISPOSITIONS InitState  
);

Parameters

ShareMode [in, defaultvalue(EXCLUSIVE)]
Mode in which to share or exclusively own the connection to the smart card.
Values Description
EXCLUSIVE No one else use this connection to the smart card.
SHARED Other applications can use this connection.

InitState [in, defaultvalue(LEAVE)]
Indicates what to do with the card.
Values Description
LEAVE Leaves the smart card in the current state.
RESET Resets the smart card to some known state.
UNPOWER Removes power from the smart card.
EJECT Ejects the smart card if the reader has eject capabilities.

Return Values

The possible return values are the following:

Value Meaning
S_OK Operation completed successfully.
E_INVALIDARG There is something wrong with one or more of the parameters passed into the function.

Remarks

In addition to the COM error codes listed above, this interface may return a smart card error code if a smart card function was called to complete the request. For information on smart card error codes, see Error Codes.

QuickInfo

  Windows NT: Use version 4.0 SP3 and later.
  Windows: Use Windows 95 OSR2.1.
  Windows CE: Unsupported.
  Header: Declared in scardmgr.h.
  Import Library: scardmgr.tlb.

See Also

AttachByHandle, AttachByReader, Detach, ISCard