ISCard::AttachByReader

The AttachByReader method opens the smart card in the named reader.

HRESULT AttachByReader(
  BSTR bstrReaderName, 
  SCARD_SHARE_MODES ShareMode, 
  SCARD_PROTOCOLS PrefProtocol
);

Parameters

bstrReaderName [in]
Pointer to the name of the smart card reader.
ShareMode [in, defaultvalue(EXCLUSIVE)]
Mode in which to claim access to the smart card.
Values Description
EXCLUSIVE No one else use this connection to the smart card.
SHARED Other applications can use this connection.

PrefProtocol [in, defaultvalue(T0)]
Preferred protocol.
Values
T0
T1
Raw
T0|T1

Return Values

The possible return values are the following:

Value Meaning
S_OK Open on the smart card in the named reader has been 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, Detach, ISCard, ReAttach