Tizen Native API
7.0
|
The SE Service API provides functions to service framework.
Required Header
#include <smartcard.h>
Related Features
This API is related with the following features:
- http://tizen.org/feature/network.secure_element
- http://tizen.org/feature/network.secure_element.ese
- http://tizen.org/feature/network.secure_element.uicc
- http://tizen.org/feature/network.secure_element.usb
It is recommended to design feature related codes in your application for reliability.
You can check if a device supports the related features for this API by using System Information, thereby controlling the procedure of your application.
To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.
More details on featuring your application can be found from Feature Element.
Functions | |
int | smartcard_initialize (void) |
Initializes smartcard service. | |
int | smartcard_deinitialize (void) |
Deinitializes smartcard service. | |
int | smartcard_get_version (char **version) |
Gets the version of SIMAlliance OpenMobileAPI specification. | |
int | smartcard_get_readers (int **readers, int *length) |
Gets the list of available Secure Element readers. |
Enumeration Type Documentation
enum smartcard_error_e |
Error codes reported by the smartcard API.
- Since :
- 2.3.1
- Enumerator:
Function Documentation
int smartcard_deinitialize | ( | void | ) |
Deinitializes smartcard service.
Releases all the resource of the smartcard service
- Since :
- 2.3.1
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/secureelement
- Returns:
- 0 on success, otherwise a negative error value.
- Return values:
-
SMARTCARD_ERROR_NONE Successful SMARTCARD_ERROR_NOT_SUPPORTED Not supported SMARTCARD_ERROR_PERMISSION_DENIED Permission denied SMARTCARD_ERROR_GENERAL A general error occurred SMARTCARD_ERROR_NOT_INITIALIZED Smartcard service not initialized
- See also:
- smartcard_initialize()
int smartcard_get_readers | ( | int ** | readers, |
int * | length | ||
) |
Gets the list of available Secure Element readers.
- Since :
- 2.3.1
- Remarks:
- readers must be released using free().
- Parameters:
-
[out] readers List of readers [out] length The number of readers
- Returns:
- 0 on success, otherwise a negative error value.
- Return values:
-
SMARTCARD_ERROR_NONE Successful SMARTCARD_ERROR_NOT_SUPPORTED Not supported SMARTCARD_ERROR_INVALID_PARAMETER Invalid function parameter SMARTCARD_ERROR_GENERAL A general error occurred SMARTCARD_ERROR_NOT_INITIALIZED Smartcard service not initialized
int smartcard_get_version | ( | char ** | version | ) |
Gets the version of SIMAlliance OpenMobileAPI specification.
- Since :
- 3.0
- Remarks:
- The version must be released using free().
- Parameters:
-
[out] version The version of SIMAlliance OpenMobileAPI specification
- Returns:
- 0 on success, otherwise a negative error value.
- Return values:
-
SMARTCARD_ERROR_NONE Successful SMARTCARD_ERROR_NOT_SUPPORTED Not supported SMARTCARD_ERROR_INVALID_PARAMETER Invalid function parameter SMARTCARD_ERROR_NOT_INITIALIZED Smartcard service not initialized SMARTCARD_ERROR_OUT_OF_MEMORY Out of memory
int smartcard_initialize | ( | void | ) |
Initializes smartcard service.
- Since :
- 2.3.1
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/secureelement
- Remarks:
- This function must be called before proceeding any other smartcard function
- Returns:
- 0 on success, otherwise a negative error value.
- Return values:
-
SMARTCARD_ERROR_NONE Successful SMARTCARD_ERROR_NOT_SUPPORTED Not supported SMARTCARD_ERROR_PERMISSION_DENIED Permission denied SMARTCARD_ERROR_GENERAL A general error occurred
- See also:
- smartcard_deinitialize()