sc_reader_state_value_t

#include <smartcard/sc_data_types.h>
 

typedef enum
      SC_SCARD_STATE_UNAWARE = 0x00000001   
      SC_SCARD_STATE_IGNORE = 0x00000002   
      SC_SCARD_STATE_UNAVAILABLE = 0x00000004   
      SC_SCARD_STATE_EMPTY = 0x00000008   
      SC_SCARD_STATE_PRESENT = 0x00000010   
      SC_SCARD_STATE_ATRMATCH = 0x00000020   
      SC_SCARD_STATE_EXCLUSIVE = 0x00000040   
      SC_SCARD_STATE_INUSE = 0x00000080   
      SC_SCARD_STATE_CHANGED = 0x00000100   
      SC_SCARD_STATE_UNKNOWN = 0x00000200   
      SC_SCARD_STATE_NOT_CONNECTED = 0x00000400   
} sc_reader_state_value_t;

Since:

BlackBerry 10.2.0

Data:

SC_SCARD_STATE_UNAWARE

When assigned to the current state, this value means that the application is unaware of the current state and wants to know.

Using this value results in an immediate return from state transition monitoring services. This is represented by all bits set to zero.

SC_SCARD_STATE_IGNORE

When assigned to the current state, this value indicates that the application is not interested in this reader, and the reader should not be considered during monitoring operations.

If this bit value is set, all other bits are ignored.

When assigned to the event state, it means that the application requested that this reader be ignored. No other bits will be set.

SC_SCARD_STATE_UNAVAILABLE

When assigned to the current state, this value means that the application has determined that this reader is not available for use.

If this bit is set, then all the following bits are ignored.

When assigned to the event state, it indicates that the actual state of this reader is not available. If this bit is set, then all the following bits are clear.

SC_SCARD_STATE_EMPTY

When assigned to the current state, this value indicates that the application has determined that there is no card in the reader.

If this bit is set, all the following bits are ignored.

When assigned to the event state, it means that there is no card in the reader. If this bit is set, all the following bits will be cleared.

SC_SCARD_STATE_PRESENT

When assigned to the current state, this value indicates that the application has determined that there is a card in the reader.

When assigned to the event state, this means that there is a card in the reader.

SC_SCARD_STATE_ATRMATCH

When assigned to the current state, this value indicates that the application has determined that there is a card in the reader with an ATR matching one of the target cards.

If this bit is set, SC_SCARD_STATE_PRESENT is assumed.

When assigned to the event state, this means that there is a card in the reader with an ATR matching one of the target cards. If this bit is set, SC_SCARD_STATE_PRESENT is also set. This bit is returned only by the sc_locate_cards() function.

SC_SCARD_STATE_EXCLUSIVE

When assigned to the current state, this value indicates that the application has determined that the card in the reader is allocated for the exclusive use by another application.

If this bit is set, SC_SCARD_STATE_PRESENT is assumed.

When assigned to the event state, this indicates that the card in the reader is allocated for the exclusive use by another application. If this bit is set, SC_SCARD_STATE_PRESENT is also set.

SC_SCARD_STATE_INUSE

When assigned to the current state, this value indicates that the application has determined that the card in the reader is in use by one or more other applications, but may be connected to in shared mode.

If this bit is set, SC_SCARD_STATE_PRESENT is assumed.

When assigned to the event state, this indicates that the card in the reader is in use by one or more other applications, but may be connected to in shared mode. If this bit is set, SC_SCARD_STATE_PRESENT is also set.

SC_SCARD_STATE_CHANGED

When assigned to the event state, this value indicates that there is a difference between the state input by the calling application and the current state.

When this bit is set, the application may determine that a significant state change has occurred on this reader.

SC_SCARD_STATE_UNKNOWN

When assigned to the event state, this value indicates that the given reader name is not recognized by the Resource Manager.

If this bit is set, then SC_SCARD_STATE_CHANGED is also set.

SC_SCARD_STATE_NOT_CONNECTED

When assigned to the current or event state, this value means that the reader is not connected to a device.

This state is not defined in the PC/SC specification.

Library:

libscs (For the qcc command, use the -l scs option to link against this library)

Description:

The application can retrieve or modify the state values by calling API functions that are defined in sc_reader_state.h.