Tizen Native API
|
Functions | |
int | app_context_destroy (app_context_h app_context) |
Destroys the application context handle and releases all its resources. | |
int | app_context_get_package (app_context_h app_context, char **package) |
Gets the package with the given application context. | |
int | app_context_get_app_id (app_context_h app_context, char **app_id) |
Gets the application ID with the given application context. | |
int | app_context_get_pid (app_context_h app_context, pid_t *pid) |
Gets the process ID with the given application context. | |
int | app_context_is_terminated (app_context_h app_context, bool *terminated) |
Checks whether the application with the given application context is terminated. | |
int | app_context_is_equal (app_context_h lhs, app_context_h rhs, bool *equal) |
Checks whether two application contexts are equal. | |
int | app_context_clone (app_context_h *clone, app_context_h app_context) |
Clones the application context handle. | |
Typedefs | |
typedef struct app_context_s * | app_context_h |
Application context handle. |
The Application Context API contains functions for obtaining information about running applications.
Required Header
#include <app_manager.h>
Overview
- Remarks:
- The Application Context API provides information about running applications.
Typedef Documentation
typedef struct app_context_s* app_context_h |
Application context handle.
- Since :
- 2.3
Enumeration Type Documentation
enum app_context_event_e |
Function Documentation
int app_context_clone | ( | app_context_h * | clone, |
app_context_h | app_context | ||
) |
Clones the application context handle.
- Since :
- 2.3
- Parameters:
-
[out] clone The newly created application context handle, if cloning is successful [in] app_context The application context
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
int app_context_destroy | ( | app_context_h | app_context | ) |
Destroys the application context handle and releases all its resources.
- Since :
- 2.3
- Parameters:
-
[in] app_context The application context handle
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
int app_context_get_app_id | ( | app_context_h | app_context, |
char ** | app_id | ||
) |
Gets the application ID with the given application context.
- Since :
- 2.3
- Remarks:
- You must release app_id using free().
- Parameters:
-
[in] app_context The application context [out] app_id The application ID of the given application context
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
int app_context_get_package | ( | app_context_h | app_context, |
char ** | package | ||
) |
Gets the package with the given application context.
- Deprecated:
- Deprecated since 2.3.1. Use app_context_get_app_id() instead.
- Since :
- 2.3
- Remarks:
- You must release package using free().
- Parameters:
-
[in] app_context The application context [out] package The package of the given application context
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter APP_MANAGER_ERROR_OUT_OF_MEMORY Out of memory
int app_context_get_pid | ( | app_context_h | app_context, |
pid_t * | pid | ||
) |
Gets the process ID with the given application context.
- Since :
- 2.3
- Parameters:
-
[in] app_context The application context [out] pid The process ID of the given application context
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
int app_context_is_equal | ( | app_context_h | lhs, |
app_context_h | rhs, | ||
bool * | equal | ||
) |
Checks whether two application contexts are equal.
- Since :
- 2.3
- Parameters:
-
[in] lhs The first application context to compare [in] rhs The second application context to compare [out] equal true
if the application contexts are equal,
otherwisefalse
if they are not equal
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
int app_context_is_terminated | ( | app_context_h | app_context, |
bool * | terminated | ||
) |
Checks whether the application with the given application context is terminated.
- Since :
- 2.3
- Parameters:
-
[in] app_context The application context [out] terminated true
if the application is terminated,
otherwisefalse
if the application is running
- Returns:
0
on success, otherwise a negative error value
- Return values:
-
APP_MANAGER_ERROR_NONE Successful APP_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter