Determine whether the UICC secure element card emulation (UICC SE CE) is enabled.
Synopsis:
#include <nfc/nfc_se_access.h>
NFC_API nfc_result_t nfc_se_is_uicc_ce_enabled(bool *enabled)
Arguments:
- enabled
-
true if the card emulation service is enabled, false otherwise.
Library:
libnfc (For the qcc command, use the -l nfc option to link against this library)
Description:
Use this function to determine if the UICC SE CE service is enabled.
Card emulation is enabled by the system when the following conditions are true:
- Card emulation is allowed by the carrier settings.
- Card emulation is allowed by the IT policies.
- NFC Connectivity is set to On on Settings > Network Connections > NFC.
- The option "When locked or backlight is off" is selected on Settings > Network Connections > NFC. If the option isn't selected, then all of the following conditions must be true:
- The device backlight is on.
- The device screen is unlocked.
- The device isn't in bedside mode.
Card emulation in the "enabled" state doesn't mean that card emulation is currently active. For card emulation to be active, you must ensure that an NFC-enabled UICC is inserted in the device and configured correctly.
Returns:
NFC_RESULT_SUCCESS if the current state of the card emulation has been retrieved successfully; or one of the following values is returned: