nfc_se_register_aid()

#include <nfc/nfc_se_access.h>
 

NFC_API nfc_result_t nfc_se_register_aid(uint32_t hSESession,                 
                                         const uint8_t *aid,                 
                                         size_t aid_len,                 
                                         app_category_type_t category,                 
                                         const char *invoke_target)

Since:

BlackBerry 10.3.0

Arguments:

hSESession

The handle to the open session.

aid

Pointer to the buffer containing the AID.

aid_len

Length of the AID.

category

The purpose of the application. This is used to help the user choose an application when an AID conflict occurs between two or more applications.

invoke_target

The target ID in a null-terminated string. When an NFC reader selects the registered AID, the NFC system includes this target ID in the invocation message it sends.

Library:

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

Description:

Use this function to register an AID to be handled by a particular secure element available on the device.

For the emulation to work, you need to make sure the technology type is set. You can retrieve the current technology type emulated by the UICC by calling nfc_se_reader_get_technology_types(). If it is set to 0, call nfc_se_reader_set_technology_types() to set the technology type.

By default, ISO14443A and ISO14443B technology types are enabled for emulation. However, it is possible that some application has changed the settings.

Feature set 1 doesn't support this function. When called in feature set 1, the function returns NFC_RESULT_UNSUPPORTED_API.

Returns: