Requires Header

#include <privilege_information.h>

Overview

A library for reading privilege information of the given privilege and API issue version. It provides the display name or description of privileges. If there's no matching privilege then it shows last token of given privilege or description string for undefined privileges.

Functions
int	privilege_info_get_display_name (const char api_version, const char privilege, char **display_name)
	Gets the display name of the given privilege.
int	privilege_info_get_display_name_by_pkgtype (const char package_type, const char api_version, const char privilege, char *display_name)
	Gets the display name of the given privilege.
int	privilege_info_get_description (const char api_version, const char privilege, char **description)
	Gets the description of the given privilege.
int	privilege_info_get_description_by_pkgtype (const char package_type, const char api_version, const char privilege, char *description)
	Gets the description of the given privilege.

Enumeration Type Documentation

enum privilege_info_error_e

Enumerations of error code for Privilege Information.

Since :: 2.3.1

Enumerator:

PRVINFO_ERROR_NONE	Successful
PRVINFO_ERROR_INVALID_PARAMETER	Invalid function parameter
PRVINFO_ERROR_OUT_OF_MEMORY	Out of memory
PRVINFO_ERROR_INTERNAL_ERROR	Unknown error

Function Documentation

int privilege_info_get_description	(	const char *	api_version,
		const char *	privilege,
		char **	description
	)

Gets the description of the given privilege.

Since :: 2.3.1

Remarks:: description must be released with free() by you.

Parameters:

[in]	api_version	The version of API
[in]	privilege	The privilege
[out]	description	The description of the privilege

Returns:: 0 on success, otherwise a negative error value.

Return values:

PRVINFO_ERROR_NONE	Successful
PRVINFO_ERROR_OUT_OF_MEMORY	Out of memory
PRVINFO_ERROR_INVALID_PARAMETER	Invalid function parameter
PRVINFO_ERROR_INTERNAL_ERROR	Unknown error

int privilege_info_get_description_by_pkgtype	(	const char *	package_type,
		const char *	api_version,
		const char *	privilege,
		char **	description
	)

Gets the description of the given privilege.

Since :: 2.3.1

Remarks:: description must be released with free() by you.; package_type must be one of followings: PRVINFO_PACKAGE_TYPE_NATIVE, PRVINFO_PACKAGE_TYPE_WEB

Parameters:

[in]	package_type	The type of application package
[in]	api_version	The version of API
[in]	privilege	The privilege
[out]	description	The description of the privilege

Returns:: 0 on success, otherwise a negative error value.

Return values:

PRVINFO_ERROR_NONE	Successful
PRVINFO_ERROR_OUT_OF_MEMORY	Out of memory
PRVINFO_ERROR_INVALID_PARAMETER	Invalid function parameter
PRVINFO_ERROR_INTERNAL_ERROR	Unknown error

int privilege_info_get_display_name	(	const char *	api_version,
		const char *	privilege,
		char **	display_name
	)

Gets the display name of the given privilege.

Since :: 2.3.1

Remarks:: display_name must be released with free() by you.

Parameters:

[in]	api_version	The version of API
[in]	privilege	The privilege
[out]	display_name	The display name of the privilege

Returns:: 0 on success, otherwise a negative error value.

Return values:

PRVINFO_ERROR_NONE	Successful
PRVINFO_ERROR_OUT_OF_MEMORY	Out of memory
PRVINFO_ERROR_INVALID_PARAMETER	Invalid function parameter
PRVINFO_ERROR_INTERNAL_ERROR	Unknown error

int privilege_info_get_display_name_by_pkgtype	(	const char *	package_type,
		const char *	api_version,
		const char *	privilege,
		char **	display_name
	)

Gets the display name of the given privilege.

Since :: 2.3.1

Remarks:: display_name must be released with free() by you.; package_type must be one of followings: PRVINFO_PACKAGE_TYPE_NATIVE, PRVINFO_PACKAGE_TYPE_WEB

Parameters:

[in]	package_type	The type of application package
[in]	api_version	The version of API
[in]	privilege	The privilege
[out]	display_name	The display name of the privilege

Returns:: 0 on success, otherwise a negative error value.

Return values:

PRVINFO_ERROR_NONE	Successful
PRVINFO_ERROR_OUT_OF_MEMORY	Out of memory
PRVINFO_ERROR_INVALID_PARAMETER	Invalid function parameter
PRVINFO_ERROR_INTERNAL_ERROR	Unknown error

Requires Header

Overview

Functions

Enumeration Type Documentation

Function Documentation