Tizen Native API
|
Functions | |
int | app_control_create (app_control_h *app_control) |
Creates an app_control handle. | |
int | app_control_destroy (app_control_h app_control) |
Destroys the app_control handle and releases all its resources. | |
int | app_control_set_operation (app_control_h app_control, const char *operation) |
Sets the operation to be performed. | |
int | app_control_get_operation (app_control_h app_control, char **operation) |
Gets the operation to be performed. | |
int | app_control_set_uri (app_control_h app_control, const char *uri) |
Sets the URI of the data. | |
int | app_control_get_uri (app_control_h app_control, char **uri) |
Gets the URI of the data. | |
int | app_control_set_mime (app_control_h app_control, const char *mime) |
Sets the explicit MIME type of the data. | |
int | app_control_get_mime (app_control_h app_control, char **mime) |
Gets the explicit MIME type of the data. | |
int | app_control_set_category (app_control_h app_control, const char *category) |
Sets the explicit category. | |
int | app_control_get_category (app_control_h app_control, char **category) |
Gets the explicit category. | |
int | app_control_set_app_id (app_control_h app_control, const char *app_id) |
Sets the ID of the application to explicitly launch. | |
int | app_control_get_app_id (app_control_h app_control, char **app_id) |
Gets the ID of the application to explicitly launch. | |
int | app_control_add_extra_data (app_control_h app_control, const char *key, const char *value) |
Adds extra data to the app_control. | |
int | app_control_add_extra_data_array (app_control_h app_control, const char *key, const char *value[], int length) |
Adds the extra data array to the app_control. | |
int | app_control_remove_extra_data (app_control_h app_control, const char *key) |
Removes the extra data from the app_control. | |
int | app_control_get_extra_data (app_control_h app_control, const char *key, char **value) |
Gets the extra data from the app_control. | |
int | app_control_get_extra_data_array (app_control_h app_control, const char *key, char ***value, int *length) |
Gets the extra data array from the app_control. | |
int | app_control_is_extra_data_array (app_control_h app_control, const char *key, bool *array) |
Checks whether the extra data associated with the given key is of array data type. | |
int | app_control_foreach_extra_data (app_control_h app_control, app_control_extra_data_cb callback, void *user_data) |
Retrieves all extra data contained in app_control. | |
int | app_control_foreach_app_matched (app_control_h app_control, app_control_app_matched_cb callback, void *user_data) |
Retrieves all applications that can be launched to handle the given app_control request. | |
int | app_control_send_launch_request (app_control_h app_control, app_control_reply_cb callback, void *user_data) |
Sends the launch request. | |
int | app_control_send_terminate_request (app_control_h app_control) |
Sends the terminate request to the application that is launched by app_control. This API is only effective for some applications that are provided by default for handling platform default app_controls. You are not allowed to terminate other general applications using this API. | |
int | app_control_reply_to_launch_request (app_control_h reply, app_control_h request, app_control_result_e result) |
Replies to the launch request sent by the caller. | |
int | app_control_clone (app_control_h *clone, app_control_h app_control) |
Creates and returns a copy of the given app_control handle. | |
int | app_control_get_caller (app_control_h app_control, char **id) |
Gets the application ID of the caller from the launch request. | |
int | app_control_is_reply_requested (app_control_h app_control, bool *requested) |
Checks whether the caller is requesting a reply from the launch request. | |
Typedefs | |
typedef struct app_control_s * | app_control_h |
App Control handle. | |
typedef void(* | app_control_reply_cb )(app_control_h request, app_control_h reply, app_control_result_e result, void *user_data) |
Called when the reply of the launch request is delivered. | |
typedef bool(* | app_control_extra_data_cb )(app_control_h app_control, const char *key, void *user_data) |
Called to retrieve the extra data contained in the app_control. | |
typedef bool(* | app_control_app_matched_cb )(app_control_h app_control, const char *appid, void *user_data) |
Called once for each matched application that can be launched to handle the given app_control request. | |
Defines | |
#define | APP_CONTROL_OPERATION_MAIN "http://tizen.org/appcontrol/operation/main" |
Definition for the app_control operation: main operation for an explicit launch. | |
#define | APP_CONTROL_OPERATION_DEFAULT "http://tizen.org/appcontrol/operation/default" |
Definition for the app_control operation: default operation for an explicit launch. | |
#define | APP_CONTROL_OPERATION_EDIT "http://tizen.org/appcontrol/operation/edit" |
Definition for the app_control operation: provides an explicit editable access to the given data. | |
#define | APP_CONTROL_OPERATION_VIEW "http://tizen.org/appcontrol/operation/view" |
Definition for the app_control operation: displays the data. | |
#define | APP_CONTROL_OPERATION_PICK "http://tizen.org/appcontrol/operation/pick" |
Definition for the app_control operation: picks an item from the data, returning what is selected. | |
#define | APP_CONTROL_OPERATION_CREATE_CONTENT "http://tizen.org/appcontrol/operation/create_content" |
Definition for the app_control operation: creates content, returning what is created. | |
#define | APP_CONTROL_OPERATION_CALL "http://tizen.org/appcontrol/operation/call" |
Definition for the app_control operation: performs a call to someone specified by the data. | |
#define | APP_CONTROL_OPERATION_SEND "http://tizen.org/appcontrol/operation/send" |
Definition for the app_control operation: delivers some data to someone else. | |
#define | APP_CONTROL_OPERATION_SEND_TEXT "http://tizen.org/appcontrol/operation/send_text" |
Definition for the app_control operation: delivers text data to someone else. | |
#define | APP_CONTROL_OPERATION_SHARE "http://tizen.org/appcontrol/operation/share" |
Definition for the app_control operation: shares an item with someone else. | |
#define | APP_CONTROL_OPERATION_MULTI_SHARE "http://tizen.org/appcontrol/operation/multi_share" |
Definition for the app_control operation: shares multiple items with someone else. | |
#define | APP_CONTROL_OPERATION_SHARE_TEXT "http://tizen.org/appcontrol/operation/share_text" |
Definition for the app_control operation: shares text data with someone else. | |
#define | APP_CONTROL_OPERATION_DIAL "http://tizen.org/appcontrol/operation/dial" |
Definition for the app_control operation: dials a number as specified by the data. | |
#define | APP_CONTROL_OPERATION_SEARCH "http://tizen.org/appcontrol/operation/search" |
Definition for the app_control operation: performs a search. | |
#define | APP_CONTROL_OPERATION_DOWNLOAD "http://tizen.org/appcontrol/operation/download" |
Definition for the app_control operation: downloads an item. | |
#define | APP_CONTROL_OPERATION_PRINT "http://tizen.org/appcontrol/operation/print" |
Definition for the app_control operation: prints content. | |
#define | APP_CONTROL_OPERATION_COMPOSE "http://tizen.org/appcontrol/operation/compose" |
Definition for the app_control operation: composes. | |
#define | APP_CONTROL_DATA_SUBJECT "http://tizen.org/appcontrol/data/subject" |
Definition for app_control optional data: the subject of a message. | |
#define | APP_CONTROL_DATA_TO "http://tizen.org/appcontrol/data/to" |
Definition for app_control optional data: e-mail addresses. | |
#define | APP_CONTROL_DATA_CC "http://tizen.org/appcontrol/data/cc" |
Definition for app_control optional data: e-mail addresses that should be carbon copied. | |
#define | APP_CONTROL_DATA_BCC "http://tizen.org/appcontrol/data/bcc" |
Definition for app_control optional data: e-mail addresses that should be blind carbon copied. | |
#define | APP_CONTROL_DATA_TEXT "http://tizen.org/appcontrol/data/text" |
Definition for app_control optional data: the content of the data is associated with APP_CONTROL_OPERATION_SEND. | |
#define | APP_CONTROL_DATA_TITLE "http://tizen.org/appcontrol/data/title" |
Definition for app_control optional data: the title of the data. | |
#define | APP_CONTROL_DATA_SELECTED "http://tizen.org/appcontrol/data/selected" |
Definition for app_control optional data: the path of a selected item. | |
#define | APP_CONTROL_DATA_PATH "http://tizen.org/appcontrol/data/path" |
Definition for app_control optional data: multiple item path to deliver. | |
#define | APP_CONTROL_DATA_SELECTION_MODE "http://tizen.org/appcontrol/data/selection_mode" |
Definition for app_control optional data: the selection type. |
The App Control API provides functions to launch other applications.
#include <app_control.h>
#define APP_CONTROL_DATA_BCC "http://tizen.org/appcontrol/data/bcc" |
Definition for app_control optional data: e-mail addresses that should be blind carbon copied.
#define APP_CONTROL_DATA_CC "http://tizen.org/appcontrol/data/cc" |
Definition for app_control optional data: e-mail addresses that should be carbon copied.
#define APP_CONTROL_DATA_PATH "http://tizen.org/appcontrol/data/path" |
Definition for app_control optional data: multiple item path to deliver.
#define APP_CONTROL_DATA_SELECTED "http://tizen.org/appcontrol/data/selected" |
Definition for app_control optional data: the path of a selected item.
#define APP_CONTROL_DATA_SELECTION_MODE "http://tizen.org/appcontrol/data/selection_mode" |
Definition for app_control optional data: the selection type.
#define APP_CONTROL_DATA_SUBJECT "http://tizen.org/appcontrol/data/subject" |
Definition for app_control optional data: the subject of a message.
#define APP_CONTROL_DATA_TEXT "http://tizen.org/appcontrol/data/text" |
Definition for app_control optional data: the content of the data is associated with APP_CONTROL_OPERATION_SEND.
#define APP_CONTROL_DATA_TITLE "http://tizen.org/appcontrol/data/title" |
Definition for app_control optional data: the title of the data.
#define APP_CONTROL_DATA_TO "http://tizen.org/appcontrol/data/to" |
Definition for app_control optional data: e-mail addresses.
#define APP_CONTROL_OPERATION_CALL "http://tizen.org/appcontrol/operation/call" |
Definition for the app_control operation: performs a call to someone specified by the data.
#define APP_CONTROL_OPERATION_COMPOSE "http://tizen.org/appcontrol/operation/compose" |
Definition for the app_control operation: composes.
#define APP_CONTROL_OPERATION_CREATE_CONTENT "http://tizen.org/appcontrol/operation/create_content" |
Definition for the app_control operation: creates content, returning what is created.
#define APP_CONTROL_OPERATION_DEFAULT "http://tizen.org/appcontrol/operation/default" |
Definition for the app_control operation: default operation for an explicit launch.
#define APP_CONTROL_OPERATION_DIAL "http://tizen.org/appcontrol/operation/dial" |
Definition for the app_control operation: dials a number as specified by the data.
#define APP_CONTROL_OPERATION_DOWNLOAD "http://tizen.org/appcontrol/operation/download" |
Definition for the app_control operation: downloads an item.
#define APP_CONTROL_OPERATION_EDIT "http://tizen.org/appcontrol/operation/edit" |
Definition for the app_control operation: provides an explicit editable access to the given data.
#define APP_CONTROL_OPERATION_MAIN "http://tizen.org/appcontrol/operation/main" |
Definition for the app_control operation: main operation for an explicit launch.
#define APP_CONTROL_OPERATION_MULTI_SHARE "http://tizen.org/appcontrol/operation/multi_share" |
Definition for the app_control operation: shares multiple items with someone else.
#define APP_CONTROL_OPERATION_PICK "http://tizen.org/appcontrol/operation/pick" |
Definition for the app_control operation: picks an item from the data, returning what is selected.
#define APP_CONTROL_OPERATION_PRINT "http://tizen.org/appcontrol/operation/print" |
Definition for the app_control operation: prints content.
#define APP_CONTROL_OPERATION_SEARCH "http://tizen.org/appcontrol/operation/search" |
Definition for the app_control operation: performs a search.
#define APP_CONTROL_OPERATION_SEND "http://tizen.org/appcontrol/operation/send" |
Definition for the app_control operation: delivers some data to someone else.
#define APP_CONTROL_OPERATION_SEND_TEXT "http://tizen.org/appcontrol/operation/send_text" |
Definition for the app_control operation: delivers text data to someone else.
#define APP_CONTROL_OPERATION_SHARE "http://tizen.org/appcontrol/operation/share" |
Definition for the app_control operation: shares an item with someone else.
#define APP_CONTROL_OPERATION_SHARE_TEXT "http://tizen.org/appcontrol/operation/share_text" |
Definition for the app_control operation: shares text data with someone else.
#define APP_CONTROL_OPERATION_VIEW "http://tizen.org/appcontrol/operation/view" |
Definition for the app_control operation: displays the data.
typedef bool(* app_control_app_matched_cb)(app_control_h app_control, const char *appid, void *user_data) |
Called once for each matched application that can be launched to handle the given app_control request.
[in] | app_control | The app_control handle |
[in] | package | The package name of the application that can handle the launch request of the given app_control |
[in] | user_data | The user data passed from the foreach function |
true
to continue with the next iteration of the loop, otherwise false
to break out of the loop typedef bool(* app_control_extra_data_cb)(app_control_h app_control, const char *key, void *user_data) |
Called to retrieve the extra data contained in the app_control.
[in] | app_control | The app_control handle |
[in] | key | The key of the value contained in the app_control |
[in] | user_data | The user data passed from the foreach function |
true
to continue with the next iteration of the loop, otherwise false
to break out of the loop typedef struct app_control_s* app_control_h |
App Control handle.
typedef void(* app_control_reply_cb)(app_control_h request, app_control_h reply, app_control_result_e result, void *user_data) |
Called when the reply of the launch request is delivered.
[in] | request | The app_control handle of the launch request that has been sent |
[in] | reply | The app_control handle in which the results of the callee are contained |
[in] | result | The result code of the launch request |
[in] | user_data | The user data passed from the callback registration function |
enum app_control_error_e |
Enumeration for App Control Error.
enum app_control_result_e |
int app_control_add_extra_data | ( | app_control_h | app_control, |
const char * | key, | ||
const char * | value | ||
) |
Adds extra data to the app_control.
[in] | app_control | The app_control handle |
[in] | key | The name of the extra data |
[in] | value | The value associated with the given key |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_KEY_REJECTED | Key not available |
int app_control_add_extra_data_array | ( | app_control_h | app_control, |
const char * | key, | ||
const char * | value[], | ||
int | length | ||
) |
Adds the extra data array to the app_control.
[in] | app_control | The app_control handle |
[in] | key | The name of the extra data |
[in] | value | The array value associated with the given key |
[in] | length | The length of the array |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_KEY_REJECTED | Key not available |
int app_control_clone | ( | app_control_h * | clone, |
app_control_h | app_control | ||
) |
Creates and returns a copy of the given app_control handle.
[out] | clone | If successful, a newly created app_control handle will be returned |
[in] | app_control | The app_control handle |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_OUT_OF_MEMORY | Out of memory |
int app_control_create | ( | app_control_h * | app_control | ) |
Creates an app_control handle.
[out] | app_control | The app_control handle to be newly created on success |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_OUT_OF_MEMORY | Out of memory |
int app_control_destroy | ( | app_control_h | app_control | ) |
Destroys the app_control handle and releases all its resources.
[in] | app_control | The app_control handle |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_OUT_OF_MEMORY | Out of memory |
int app_control_foreach_app_matched | ( | app_control_h | app_control, |
app_control_app_matched_cb | callback, | ||
void * | user_data | ||
) |
Retrieves all applications that can be launched to handle the given app_control request.
[in] | app_control | The app_control handle |
[in] | callback | The iteration callback function |
[in] | user_data | The user data to be passed to the callback function |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Success |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
int app_control_foreach_extra_data | ( | app_control_h | app_control, |
app_control_extra_data_cb | callback, | ||
void * | user_data | ||
) |
Retrieves all extra data contained in app_control.
This function calls app_control_extra_data_cb() once for each key-value pair for extra data contained in app_control.
If the app_control_extra_data_cb() callback function returns false
, then iteration will be finished.
[in] | app_control | The app_control handle |
[in] | callback | The iteration callback function |
[in] | user_data | The user data to be passed to the callback function |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
int app_control_get_app_id | ( | app_control_h | app_control, |
char ** | app_id | ||
) |
Gets the ID of the application to explicitly launch.
[in] | app_control | The app_control handle |
[out] | app_id | The ID of the application to explicitly launch |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_OUT_OF_MEMORY | Out of memory |
int app_control_get_caller | ( | app_control_h | app_control, |
char ** | id | ||
) |
Gets the application ID of the caller from the launch request.
[in] | app_control | The app_control handle from app_control_cb() |
[out] | id | The application ID of the caller |
APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_OUT_OF_MEMORY | Out of memory |
int app_control_get_category | ( | app_control_h | app_control, |
char ** | category | ||
) |
Gets the explicit category.
[in] | app_control | The app_control handle |
[out] | category | The explicit category |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_OUT_OF_MEMORY | Out of memory |
int app_control_get_extra_data | ( | app_control_h | app_control, |
const char * | key, | ||
char ** | value | ||
) |
Gets the extra data from the app_control.
[in] | app_control | The app_control handle |
[in] | key | The name of the extra data |
[out] | value | The value associated with the given key |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_KEY_NOT_FOUND | Specified key not found |
APP_CONTROL_ERROR_OUT_OF_MEMORY | Out of memory |
APP_CONTROL_ERROR_INVALID_DATA_TYPE | Invalid data type |
int app_control_get_extra_data_array | ( | app_control_h | app_control, |
const char * | key, | ||
char *** | value, | ||
int * | length | ||
) |
Gets the extra data array from the app_control.
[in] | app_control | The app_control handle |
[in] | key | The name of the extra data |
[out] | value | The array value associated with the given key |
[out] | length | The length of the array |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_KEY_NOT_FOUND | Specified key not found |
APP_CONTROL_ERROR_OUT_OF_MEMORY | Out of memory |
APP_CONTROL_ERROR_INVALID_DATA_TYPE | Invalid data type |
int app_control_get_mime | ( | app_control_h | app_control, |
char ** | mime | ||
) |
Gets the explicit MIME type of the data.
[in] | app_control | The app_control handle |
[out] | mime | The explicit MIME type of the data this app_control is operating on |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_OUT_OF_MEMORY | Out of memory |
int app_control_get_operation | ( | app_control_h | app_control, |
char ** | operation | ||
) |
Gets the operation to be performed.
[in] | app_control | The app_control handle |
[out] | operation | The operation to be performed |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_OUT_OF_MEMORY | Out of memory |
int app_control_get_uri | ( | app_control_h | app_control, |
char ** | uri | ||
) |
Gets the URI of the data.
[in] | app_control | The app_control handle |
[out] | uri | The URI of the data this app_control is operating on |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_OUT_OF_MEMORY | Out of memory |
int app_control_is_extra_data_array | ( | app_control_h | app_control, |
const char * | key, | ||
bool * | array | ||
) |
Checks whether the extra data associated with the given key is of array data type.
[in] | app_control | The app_control handle |
[in] | key | The name of the extra data |
[out] | array | If true the extra data is of array data type, otherwise false |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
int app_control_is_reply_requested | ( | app_control_h | app_control, |
bool * | requested | ||
) |
Checks whether the caller is requesting a reply from the launch request.
[in] | app_control | The app_control handle from app_control_cb() |
[out] | requested | If true a reply is requested by the caller, otherwise false |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_OUT_OF_MEMORY | Out of memory |
int app_control_remove_extra_data | ( | app_control_h | app_control, |
const char * | key | ||
) |
Removes the extra data from the app_control.
[in] | app_control | The app_control handle |
[in] | key | The name of the extra data |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_KEY_NOT_FOUND | Specified key not found |
int app_control_reply_to_launch_request | ( | app_control_h | reply, |
app_control_h | request, | ||
app_control_result_e | result | ||
) |
Replies to the launch request sent by the caller.
If the caller application sent the launch request to receive the result, the callee application can return the result back to the caller.
[in] | reply | The app_control handle in which the results of the callee are contained |
[in] | request | The app_control handle sent by the caller |
[in] | result | The result code of the launch request |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_OUT_OF_MEMORY | Out of memory |
int app_control_send_launch_request | ( | app_control_h | app_control, |
app_control_reply_cb | callback, | ||
void * | user_data | ||
) |
Sends the launch request.
The operation is mandatory information for the launch request.
If the operation is not specified, APP_CONTROL_OPERATION_DEFAULT is used by default. If the operation is APP_CONTROL_OPERATION_DEFAULT, the application ID is mandatory to explicitly launch the application.
[in] | app_control | The app_control handle |
[in] | callback | The callback function to be called when the reply is delivered |
[in] | user_data | The user data to be passed to the callback function |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_OUT_OF_MEMORY | Out of memory |
APP_CONTROL_ERROR_APP_NOT_FOUND | The application to run the given launch request is not found |
APP_CONTROL_ERROR_LAUNCH_REJECTED | The application cannot be launched in current context |
APP_CONTROL_ERROR_LAUNCH_FAILED | Failed to launch the application |
APP_CONTROL_ERROR_TIMED_OUT | Failed due to timeout. The application that handles app_control may be busy |
APP_CONTROL_ERROR_PERMISSION_DENIED | Permission denied |
int app_control_send_terminate_request | ( | app_control_h | app_control | ) |
Sends the terminate request to the application that is launched by app_control. This API is only effective for some applications that are provided by default for handling platform default app_controls. You are not allowed to terminate other general applications using this API.
[in] | app_control | The app_control handle |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_PERMISSION_DENIED | Permission denied |
int app_control_set_app_id | ( | app_control_h | app_control, |
const char * | app_id | ||
) |
Sets the ID of the application to explicitly launch.
[in] | app_control | The app_control handle |
[in] | app_id | The ID of the application to explicitly launch (if the app_id is NULL , it clears the previous value) |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
APP_CONTROL_ERROR_OUT_OF_MEMORY | Out of memory |
int app_control_set_category | ( | app_control_h | app_control, |
const char * | category | ||
) |
Sets the explicit category.
[in] | app_control | The app_control handle |
[in] | category | The explicit category (if the category is NULL , it clears the previous value) |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
int app_control_set_mime | ( | app_control_h | app_control, |
const char * | mime | ||
) |
Sets the explicit MIME type of the data.
[in] | app_control | The app_control handle |
[in] | mime | The explicit MIME type of the data this app_control is operating on (if the mime is NULL , it clears the previous value) |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
int app_control_set_operation | ( | app_control_h | app_control, |
const char * | operation | ||
) |
Sets the operation to be performed.
The operation is the mandatory information for the launch request. If the operation is not specified, APP_CONTROL_OPERATION_DEFAULT is used for the launch request. If the operation is APP_CONTROL_OPERATION_DEFAULT, the package information is mandatory to explicitly launch the application.
[in] | app_control | The app_control handle |
[in] | operation | The operation to be performed (if the operation is NULL , it clears the previous value) |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |
int app_control_set_uri | ( | app_control_h | app_control, |
const char * | uri | ||
) |
Sets the URI of the data.
[in] | app_control | The app_control handle |
[in] | uri | The URI of the data this app_control is operating on (if the uri is NULL , it clears the previous value) |
0
on success, otherwise a negative error value APP_CONTROL_ERROR_NONE | Successful |
APP_CONTROL_ERROR_INVALID_PARAMETER | Invalid parameter |