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.

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 application ID 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.

Typedef Documentation

typedef struct app_context_s* app_context_h

Application context handle.

Since :: 2.3.1

Enumeration Type Documentation

enum app_context_event_e

Enumeration for Application Context Event.

Since :: 2.3.1

Enumerator:

APP_CONTEXT_EVENT_LAUNCHED	The application is launched
APP_CONTEXT_EVENT_TERMINATED	The application is terminated

Function Documentation

int app_context_clone	(	app_context_h *	clone,
		app_context_h	app_context
	)

Clones the application context handle.

Since :: 2.3.1

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.1

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

See also:: app_manager_foreach_app_context(); app_manager_get_app_context()

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.1

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 application ID with the given application context.

Deprecated:: Deprecated since 2.3.1. Use app_context_get_app_id() instead.

Since :: 2.3.1

Remarks:: You must release package using free().

Parameters:

[in]	app_context	The application context
[out]	package	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_pid	(	app_context_h	app_context,
		pid_t *	pid
	)

Gets the process ID with the given application context.

Since :: 2.3.1

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.1

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, otherwise `false` 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.1

Parameters:

[in]	app_context	The application context
[out]	terminated	`true` if the application is terminated, otherwise `false` 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

Required Header

Overview

Functions

Typedefs

Typedef Documentation

Enumeration Type Documentation

Function Documentation