Ubisys 7047, Reference Manual

Page: 43 / 54

43 www.ubisys.de

9.2.4.1. Local Type Definitions
The type tstring is defined locally (see CSmartCardContext):

typedef std::basic_string<TCHAR> tstring;
9.2.4.2. Constructor
No constructor is explicitly declared. A default constructor will be generated.
9.2.4.3. Destructor
A virtual destructor is provided, in case an application might need it.
9.2.4.4. Methods

virtual void OnReaderAdded( const tstring &strReader);
This method will be called when a new reader is added to the system.

virtual void OnReaderRemoved( const tstring &strReader);
This method will be called when a reader is removed from the system.

virtual void OnReaderEvent( const tstring &strReader,
const DWORD dwCurrentState, const DWORD dwChanges,
const std::vector< unsigned char >& vbATR);
This method will be called for events on a specific card/tag. dwCurrentState indicates the current
state and consists of SCARD_STATE_XXX flags. dwChanges encodes the same flags, but only
indicates changes compared to the previous call. The ATR string (if available) is passed as a
vector<unsigned char>.
Please note that if a tag is lost and found again between two calls, this does not result in the
SCARD_STATE_PRESENT flag being set in the dwChanges parameter. This change will only
occur if the function got called at least once with SCARD_STATE_PRESENT cleared and again
with SCARD_STATE_PRESENT.
9.2.5. CSmartCardStatusListener
Provides an easy way to build an event-driven application which automatically reacts to tag/card
events, e.g. availability/non-availability of tags (inserted/ejected cards), and the addition and removal of
reader devices.