sc_get_key_store_data()

#include <smartcard/sc_smart_card.h>
 

sc_response_code_t sc_get_key_store_data(sc_context_t *context,                 
                                         sc_key_store_data_t **key_store_data,                 
                                         size_t *num_key_store_data_elements)

Since:

BlackBerry 10.2.0

Arguments:

context

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

key_store_data

An array of key store data instances to be populated with data. If NULL, only the size of the key store data collection is retrieved.

num_key_store_data_elements

On input, this value indicates the number of elements in the key_store_data array. On output, the value specifies the number of key store data instances that were populated with data. This value cannot be NULL.

Library:

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

Description:

The returned collection of key store data describes all private and symmetric keys stored on the card including any certificates associated with those keys.

A handle of type SC_HANDLE_CARD_CRYPTO_PROVIDER_X must be allocated before calling this function; otherwise, an error is returned.

Returns:

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