Ubisys 7047, Reference Manual

Page: 42 / 54

42 www.ubisys.de

9.2.2.3. Methods

SCARDHANDLE GetHandle();
Obtains a handle to be used directly with the Smart Card API functions.

DWORD GetProtocol();
Obtains the negotiated protocol.

void ExchangeAPDU( const std::vector< unsigned char > &apduOut,
std::vector< unsigned char > &apduIn);
Exchange APDUs with the tag. The APDU to be sent and received is passed as a vector. The
APDU to be received (adpuIn) shall have a capacity matching the expected response, i.e. by calling
apduIn.reserve(). If no memory was reserved, the maximum response APDU size (for a short APDU)
will be allocated.

size_t ExchangeAPDU( const unsigned char * const pbOut, const size_t cbOut,
unsigned char * const pbIn, const size_t nCapacityIn);
Exchange APDUs with the tag. The APDU to be sent and received is passed as void pointers
together with the corresponding size parameters. The number of bytes actually received is returned.

void BeginTransaction();
Begin a transaction. Block other application from accessing the tag simultaneously, e.g. when using
authentication functions, which require a strict order. The use of the CSmartCardTransaction class
is highly recommended.

void EndTransaction( const DWORD dwDisposition = SCARD_LEAVE_CARD);
End a previously started transaction.
9.2.3. CSmartCardTransaction
Start a transaction, which spans the current scope. Calls CSmartCard::BeginTransaction() upon
construction and CSmartCard::EndTransaction upon destruction.
This class provides a convenient and exception-safe way to handle transactions.
9.2.4. CSmartCardStatusReceiver
Provides a base class type for a status event receiver. An application must derive from this class to
receive events in conjunction with CSmartCardStatusListener.