|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.linuxnet.jpcsc.Context
The Context class wraps the PCSC functions related to connecting/disconnecting to the PCSC service and card readers. An invocation of Connect() returns a connection to a Card allowing for the transmission of APDUs.
Constructor Summary | |
Context()
Constructor. |
Method Summary | |
void |
Cancel()
Cancel all pending GetStatusChange() calls. |
Card |
Connect()
Connect to a reader. |
Card |
Connect(int dwShareMode,
int dwPreferredProtocols)
Connect to a reader. |
Card |
Connect(java.lang.String szReader)
Connect to a reader. |
Card |
Connect(java.lang.String szReader,
int dwShareMode,
int dwPreferredProtocols)
Connect to a reader and return handle to card. |
void |
EstablishContext(int dwScope,
java.lang.String pvReserved1,
java.lang.String pvReserved2)
Establish PCSC context. |
protected void |
finalize()
Cleanup operation. |
boolean |
GetStatusChange(int timeout,
State[] readerStates)
Return status change of a set of readers. |
java.lang.String[] |
ListReaderGroups()
List all reader groups known to the system. |
java.lang.String[] |
ListReaders()
List all readers in all existing groups. |
java.lang.String[] |
ListReaders(java.lang.String group)
List all readers in the given group. |
java.lang.String[] |
ListReaders(java.lang.String[] groups)
List all readers in the given groups. |
void |
ReleaseContext()
Release context. |
static java.lang.String |
StringifyError(int code)
Return symbolic representation of an error. |
State |
WaitForCard(int millis)
This method blocks until a card is inserted into a reader, or the specified time has been expired. |
State |
WaitForCard(java.lang.String rdrName,
int millis)
This method blocks until a card is inserted into the specified reader, or the specified time has been expired. |
Methods inherited from class java.lang.Object |
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public Context()
Method Detail |
protected final void finalize()
public final void EstablishContext(int dwScope, java.lang.String pvReserved1, java.lang.String pvReserved2)
dwScope
- PCSC.SCOPE_USER, PCSC.SCOPE_TERMINAL, PCSC.SCOPE_SYSTEMor PCSC.SCOPE_GLOBAL.pvReserved1
- unused, may be null.pvReserved2
- unused, may be null.
public final void ReleaseContext()
public final java.lang.String[] ListReaders()
public final java.lang.String[] ListReaders(java.lang.String group)
group
- name of the reader group.
public final java.lang.String[] ListReaders(java.lang.String[] groups)
groups
- arrays of Strings naming the groups.
java.lang.IllegalArgumentException
- if one of the group names is null.public final java.lang.String[] ListReaderGroups()
public State WaitForCard(int millis)
millis
- Waiting time, pass PCSC.INFINITE for indefinite waiting time.
public State WaitForCard(java.lang.String rdrName, int millis)
millis
- Waiting time, pass PCSC.INFINITE to wait indefinitely.
public final boolean GetStatusChange(int timeout, State[] readerStates)
timeout
- time to wait blocked until status changes as requested.readerStates
- array of State objects naming events and readers to observe.
public final Card Connect()
public final Card Connect(int dwShareMode, int dwPreferredProtocols)
dwShareMode
- PCSC.SHARE_EXCLUSIVE, PCSC.SHARE_SHARED or PCSC.SHARE_DIRECT.dwPreferredProtocols
- PCSC.PROTOCOL_T0, PCSC.PROTOCOL_T1, PCSC.PROTOCOL_RAW, PCSC.PROTOCOL_ANY.
public final Card Connect(java.lang.String szReader)
szReader
- name of the reader, must not be null.
public final Card Connect(java.lang.String szReader, int dwShareMode, int dwPreferredProtocols)
szReader
- name of the reader, must not be nulldwShareMode
- PCSC.SHARE_EXCLUSIVE, PCSC.SHARE_SHARED or PCSC.SHARE_DIRECT.dwPreferredProtocols
- PCSC.PROTOCOL_T0, PCSC.PROTOCOL_T1, PCSC.PROTOCOL_RAW, PCSC.PROTOCOL_ANY.
public final void Cancel()
public static java.lang.String StringifyError(int code)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |