Tizen Native API
Privilege Info

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

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_versionThe version of API
[in]privilegeThe privilege
[out]descriptionThe description of the privilege
Returns:
0 on success, otherwise a negative error value.
Return values:
PRVINFO_ERROR_NONESuccessful
PRVINFO_ERROR_OUT_OF_MEMORYOut of memory
PRVINFO_ERROR_INVALID_PARAMETERInvalid function parameter
PRVINFO_ERROR_INTERNAL_ERRORUnknown 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_typeThe type of application package
[in]api_versionThe version of API
[in]privilegeThe privilege
[out]descriptionThe description of the privilege
Returns:
0 on success, otherwise a negative error value.
Return values:
PRVINFO_ERROR_NONESuccessful
PRVINFO_ERROR_OUT_OF_MEMORYOut of memory
PRVINFO_ERROR_INVALID_PARAMETERInvalid function parameter
PRVINFO_ERROR_INTERNAL_ERRORUnknown 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_versionThe version of API
[in]privilegeThe privilege
[out]display_nameThe display name of the privilege
Returns:
0 on success, otherwise a negative error value.
Return values:
PRVINFO_ERROR_NONESuccessful
PRVINFO_ERROR_OUT_OF_MEMORYOut of memory
PRVINFO_ERROR_INVALID_PARAMETERInvalid function parameter
PRVINFO_ERROR_INTERNAL_ERRORUnknown 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_typeThe type of application package
[in]api_versionThe version of API
[in]privilegeThe privilege
[out]display_nameThe display name of the privilege
Returns:
0 on success, otherwise a negative error value.
Return values:
PRVINFO_ERROR_NONESuccessful
PRVINFO_ERROR_OUT_OF_MEMORYOut of memory
PRVINFO_ERROR_INVALID_PARAMETERInvalid function parameter
PRVINFO_ERROR_INTERNAL_ERRORUnknown error