|
Tizen Native API
|
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 It is recommended to design feature related codes in your application for reliability.
You can check if a devrice 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_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_GENERAL A general error occurred SMARTCARD_ERROR_NOT_INITIALIZED Smartcard service not initialized SMARTCARD_ERROR_NOT_SUPPORTED Not supported SMARTCARD_ERROR_PERMISSION_DENIED Permission denied
- 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_GENERAL A general error occurred SMARTCARD_ERROR_INVALID_PARAMETER Invalid function parameter SMARTCARD_ERROR_NOT_INITIALIZED Smartcard service not initialized SMARTCARD_ERROR_NOT_SUPPORTED Not supported
| 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_GENERAL A general error occurred SMARTCARD_ERROR_NOT_SUPPORTED Not supported SMARTCARD_ERROR_PERMISSION_DENIED Permission denied
- See also:
- smartcard_deinitialize()