sc_locate_cards()

Retrieve card states for the cards of interest.

Synopsis:

#include <smartcard/sc_smart_card.h>

sc_response_code_t sc_locate_cards(sc_context_t *context,                 
                                   const sc_card_name_t *cards,                 
                                   size_t num_cards,                 
                                   sc_reader_state_t **reader_states,                 
                                   size_t num_reader_states)

Since:

BlackBerry 10.2.0

Arguments:

context: The active smart card context. This value cannot be NULL.

cards: Array of card types of interest.

num_cards: Number of elements in the cards array.

reader_states: On input, the array describes the set of readers of interest. On output, the array contains information that indicates whether a card matching one of the specified card types is present.

num_reader_states: Number of elements in reader_states.

Library:

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

Description:

The value of the event_state field of each sc_reader_state_t instance indicates whether a card that matches one of the specified card types is present. Unknown card types are ignored. If an unknown reader is specified, an error is returned.

To block a pending insertion of the expected card types, use sc_get_status_change().

Returns:

SC_SCARD_S_SUCCESS upon success, an error code otherwise. See sc_response_code_t for defined error codes.