This is a key of app_control_h’s extra data. The value of the key is account DB ID of the user’s account information.

Since :

2.3

Remarks:

You can retrieve the value like this, app_control_get_extra_data(app_control, ACCOUNT_DATA_ID, &id).
This value will be sent with ACCOUNT_OPERATION_VIEW.

This is a key of app_control_h’s extra data. The value of the key is a user account name.

Since :

2.3

Remarks:

You can retrieve the value like this, app_control_get_extra_data(app_control, ACCOUNT_DATA_USERNAME, &username).
This value will be sent with ACCOUNT_OPERATION_VIEW.

The delete notification type.

Since :

2.3

Remarks:

When the account database is changed, You can distinguish one event type from the other which are set for subscribing notification.

See also:

account_subscribe_notification()

The insert notification type.

Since :

2.3

Remarks:

When the account database is changed, You can distinguish one event type from the other which are set for subscribing notification.

See also:

account_subscribe_notification()

The sync_update notification type.

Since :

2.3

Remarks:

When the account database is changed, You can distinguish one event type from the other which are set for subscribing notification.

See also:

account_subscribe_notification()

The update notification type.

Since :

2.3

Remarks:

When the account database is changed, You can distinguish one event type from the other which are set for subscribing notification.

See also:

account_subscribe_notification()

This is an application launch operation name.

Since :

2.3

Remarks:

This operation will be sent when a user selects your account in add account view.

This is an application launch operation name.

Since :

2.3

Remarks:

This operation will be sent when a user selects your account in account list view.

This is calendar capability string.

Since :

2.3

Remarks:

If your provider service has calendar information and calendar information is provided another application, register this capability through manifest file.

This is contact capability string.

Since :

2.3

Remarks:

If your provider service has contact information and contact information is provided another application, register this capability through manifest file.

This is document capability string.

Since :

2.3

Remarks:

If your provider service has document and document is provided another application, register this capability through manifest file.

This is email capability string.

Since :

2.3

Remarks:

If your provider service have email service and email is provided another application, register this capability through manifest file.

This is game capability string.

Since :

2.3

Remarks:

This capability will be exploited to use game data.

This is message capability string.

Since :

2.3

Remarks:

This capability will be exploited to use SMS, MMS.

This is music capability string.

Since :

2.3

Remarks:

If your provider service has music and music is provided another application, register this capability through manifest file.

This is photo capability string.

Since :

2.3

Remarks:

If your provider service has photo and photo is provided another application, register this capability through manifest file.

This is video capability string.

Since :

2.3

Remarks:

If your provider service has video and video is provided another application, register this capability through manifest file.

Called once for each account from the database.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	user_data	The user data passed from the foreach function

Returns:

true to continue with the next iteration of the loop,
otherwise false to break out of the loop

Precondition:

account_foreach_account_from_db(), account_query_account_by_account_id(), account_query_account_by_user_name() or account_query_account_by_package_name() must be called.

See also:

account_foreach_account_from_db()

account_query_account_by_account_id()

account_query_account_by_user_name()

account_query_account_by_package_name()

Called once for each custom data of an account in the database.

Since :

2.3

Parameters:

[in]	key	The user custom key
[in]	value	The user custom value of the specific key
[in]	user_data	The user data passed

Returns:

true to continue with the next iteration of the loop,
otherwise false to break out of the loop

Precondition:

account_query_capability_by_account_id() must be called.

See also:

account_query_capability_by_account_id()

Called once when an event occurs.

Since :

2.3

Parameters:

[in]	event_type	The account event type
[in]	account_id	The account ID to update
[in]	user_data	The user data passed

Returns:

true to continue with the next iteration of the loop,
otherwise false to break out of the loop

Precondition:

account_subscribe_notification() must be called.

See also:

account_subscribe_notification()

The structure type for the Account handle.

Since :

2.3

Called once for each account label.

Since :

2.3

Parameters:

[in]	app_id	The application ID
[in]	label	The name of the account depends on the specified locale
[in]	locale	The locale is specified as an ISO 3166 alpha-2 two letter country-code followed by ISO 639-1 for the two-letter language code. For example, "ko_KR" for Korean, "en_US" for American English.
[in]	user_data	The user data passed

Returns:

true to continue with the next iteration of the loop,
otherwise false to break out of the loop

Precondition:

account_type_get_label(), account_type_query_label_by_app_id() must be called.

See also:

account_type_get_label()

account_type_query_label_by_app_id()

The structure type for the Account subscribe handle.

Since :

2.3

Called once for each account provider in the database.

Since :

2.3

Parameters:

[in]	account_type	The account provider handle
[in]	user_data	The user data passed

Returns:

true to continue with the next iteration of the loop,
otherwise false to break out of the loop

Precondition:

account_type_foreach_account_type_from_db(), account_type_query_by_provider_feature() must be called.

See also:

account_type_foreach_account_type_from_db()

account_type_query_by_provider_feature()

The structure type for the Account provider handle.

Since :

2.3

Called once for each capability of an account in the database.

Since :

2.3

Parameters:

[in]	capability_type	The capability type
[in]	capability_state	The capability state
[in]	user_data	The user data passed from the foreach function

Returns:

true to continue with the next iteration of the loop,
otherwise false to break out of the loop

Precondition:

account_query_capability_by_account_id() must be called.

See also:

account_query_capability_by_account_id()

The structure type for the Account handle.

Since :

2.3

Called once for each capability of an account provider in the database.

Since :

2.3

Parameters:

[in]	app_id	The application ID
[in]	key	The user custom key
[in]	user_data	The user data passed

Returns:

true to continue with the next iteration of the loop,
otherwise false to break out of the loop

Precondition:

account_type_query_provider_feature_by_app_id(), account_type_get_provider_feature_all() must be called.

See also:

account_type_query_provider_feature_by_app_id()

account_type_get_provider_feature_all()

Enumeration for the account auth type.

Since :

2.3

Enumerator:

ACCOUNT_AUTH_TYPE_INVALID	Auth type is invalid
ACCOUNT_AUTH_TYPE_XAUTH	XAuth type
ACCOUNT_AUTH_TYPE_OAUTH	OAuth type
ACCOUNT_AUTH_TYPE_CLIENT_LOGIN	Client-Login type

Enumeration for the state of capability.

Since :

2.3

Enumerator:

ACCOUNT_CAPABILITY_STATE_INVALID	Account capability is invalid
ACCOUNT_CAPABILITY_DISABLED	Account capability is disabled
ACCOUNT_CAPABILITY_ENABLED	Account capability is enabled

Enumerations of error codes for ACCOUNT APIs.

Since :

2.3

Enumerator:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of memory
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_DUPLICATED	Same user name exists in your application
ACCOUNT_ERROR_NO_DATA	Empty data
ACCOUNT_ERROR_RECORD_NOT_FOUND	Related record does not exist
ACCOUNT_ERROR_DB_FAILED	DB operation failed
ACCOUNT_ERROR_DB_NOT_OPENED	DB is not connected
ACCOUNT_ERROR_QUERY_SYNTAX_ERROR	DB query syntax error
ACCOUNT_ERROR_ITERATOR_END	Iterator has reached the end
ACCOUNT_ERROR_NOTI_FAILED	Notification failed
ACCOUNT_ERROR_PERMISSION_DENIED	Permission denied
ACCOUNT_ERROR_XML_PARSE_FAILED	XML parse failed
ACCOUNT_ERROR_XML_FILE_NOT_FOUND	XML file does not exist
ACCOUNT_ERROR_EVENT_SUBSCRIPTION_FAIL	Subscription failed
ACCOUNT_ERROR_NOT_REGISTERED_PROVIDER	Account provider is not registered
ACCOUNT_ERROR_NOT_ALLOW_MULTIPLE	Multiple accounts are not supported
ACCOUNT_ERROR_DATABASE_BUSY	SQLite busy handler expired
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported (Since 4.0)
ACCOUNT_ERROR_OPERATION_FAIL	Account operation failed (Since 4.0)

Enumeration for the state of account secrecy.

Since :

2.3

Enumerator:

ACCOUNT_SECRECY_INVALID	Account secrecy is invalid
ACCOUNT_SECRECY_INVISIBLE	Account is not visible
ACCOUNT_SECRECY_VISIBLE	Account is visible

Enumeration for the account sync status.

Since :

2.3

Enumerator:

ACCOUNT_SYNC_INVALID	Account sync is invalid
ACCOUNT_SYNC_NOT_SUPPORT	Account sync not supported
ACCOUNT_SYNC_STATUS_OFF	Account sync supported but all synchronization functionalities are off
ACCOUNT_SYNC_STATUS_IDLE	Account sync support and sync status is idle
ACCOUNT_SYNC_STATUS_RUNNING	Account sync support and sync status is running
ACCOUNT_SUPPORTS_SYNC	NOT USED, WILL BE REMOVED TO PREVENT BUILD ERROR
ACCOUNT_NOT_SUPPORTS_SYNC	NOT USED, WILL BE REMOVED TO PREVENT BUILD ERROR

Connects to the account database by readwrite mode.

Deprecated:

Deprecated since Tizen 2.4.
This API is not necessary to use since Tizen 2.4.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read
http://tizen.org/privilege/account.wirte

Remarks:

This API need both privileges

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_DB_NOT_OPENED	DB is not connected
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission

Connects to the account database by readonly mode.

Deprecated:

Deprecated since Tizen 2.4.
This API is not necessary to use since Tizen 2.4.

Since :

2.3

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_DB_NOT_OPENED	DB is not connected
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission

Creates a handle to the account.

Since :

2.3

Remarks:

Release account using account_destroy().

The created handle is not added to the account database until account_insert_to_db() is called.

Parameters:

[in]

account

The account handle

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of Memory
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_destroy()

Deletes an account from the account database by account DB ID.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read
http://tizen.org/privilege/account.write

Remarks:

This API need both privileges
Only can delete an account which was added by same package applications

Parameters:

[in]

account_db_id

The account ID to delete

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of Memory
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_PERMISSION_DENIED	The account owner is different from the caller or DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

See also:

account_insert_to_db()

account_delete_from_db_by_user_name()

account_delete_from_db_by_package_name()

account_update_to_db_by_id()

account_update_to_db_by_user_name()

Deletes an account from the account database by package name.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read
http://tizen.org/privilege/account.write

Remarks:

This API need both privileges
Only can delete accounts which was added by same package applications

Parameters:

[in]

package_name

The package name of account(s) to delete

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

See also:

account_insert_to_db()

account_delete_from_db_by_id()

account_delete_from_db_by_user_name()

account_update_to_db_by_id()

account_update_to_db_by_user_name()

Deletes an account from the account database by user name.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read
http://tizen.org/privilege/account.write

Remarks:

This API need both privileges
Only can delete accounts which were added by same package applications

Parameters:

[in]	user_name	The user name of the account to delete
[in]	package_name	The package name of the account to delete

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of Memory
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

See also:

account_insert_to_db()

account_delete_from_db_by_id()

account_delete_from_db_by_package_name()

account_update_to_db_by_id()

account_update_to_db_by_user_name()

Destroys the account handle and releases all its resources.

Since :

2.3

Parameters:

[in]

account

The account handle

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_create()

Disconnects from the account database.

Deprecated:

Deprecated since Tizen 2.4.
This API is not necessary to use since Tizen 2.4.

Since :

2.3

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite busy handler exprired

Retrieves all accounts details by invoking the given callback function iteratively.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read

Parameters:

[in]	callback	The callback function to invoke
[in]	user_data	The user data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_RECORD_NOT_FOUND	Related record does not exist
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

Postcondition:

This function invokes account_cb().

See also:

account_query_account_by_account_id()

account_query_account_by_user_name()

account_query_account_by_package_name()

account_query_account_by_capability()

Gets the access token. Access token field is used to store account secrets (such as password or master token).

Since :

2.3

Remarks:

You must release access_token using free().

Access token field is used for storing account secret (password / master token etc)

Parameters:

[in]	account	The account handle
[out]	access_token	The access token

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of memory
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Only account owner application can retrieve account password / access_token. For others this field will be null.

See also:

account_set_access_token()

Gets the ID of an account.

Since :

2.3

Parameters:

[in]	account	The account handle
[out]	account_id	The account ID

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Gets the authentiacation type.

Since :

2.3

Parameters:

[in]	account	The account handle
[out]	auth_type	The authentiacation type

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_set_auth_type()

Gets the capability detail of an account.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	capability_type	The capability type to get the capability value
[out]	capability_value	The capability value (on/off) of the specified capability_type

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_RECORD_NOT_FOUND	There is no given capability_type in the account
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_set_capability()

Gets all the capabilities of an account.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	callback	The callback function
[in]	user_data	The user data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_set_capability()

Gets the user specific custom text of an account key.

Since :

2.3

Remarks:

You must release value using free().

Parameters:

[in]	account	The account handle
[in]	key	The key to retrieve custom text
[out]	value	The text of the given key

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_RECORD_NOT_FOUND	There is no given capability type in the account
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_set_custom()

Gets all the user custom texts of an account.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	callback	The callback function to retrieve all custom text The callback function gives the key and value.
[in]	user_data	The user data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_set_custom()

Gets the display name of an account.

Since :

2.3

Remarks:

You must release display_name using free().

Parameters:

[in]	account	The account handle
[out]	display_name	The display name of the account

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of memory
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_get_display_name()

Gets the domain name.

Since :

2.3

Remarks:

You must release domain_name using free().

Parameters:

[in]	account	The account handle
[out]	domain_name	The domain name

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of memory
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_set_domain_name()

Gets the email address.

Since :

2.3

Remarks:

You must release email_address using free().

Parameters:

[in]	account	The account handle
[out]	email_address	The email address

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of memory
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_set_email_address()

Gets the icon path.

Since :

2.3

Remarks:

You must release icon_path using free().

Parameters:

[in]	account	The account handle
[out]	icon_path	The icon path

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of memory
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_set_icon_path()

Gets the package name.

Since :

2.3

Remarks:

You must release package_name using free().

Parameters:

[in]	account	The account handle
[out]	package_name	The package name

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of memory
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_set_package_name()

Gets the secret.

Since :

2.3

Parameters:

[in]	account	The account handle
[out]	secret	The secret

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_set_secret()

Gets the source.

Since :

2.3

Remarks:

You must release source using free().

Parameters:

[in]	account	The account handle
[out]	source	The source

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of memory
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_set_source()

Gets the sync support.

Since :

2.3

Parameters:

[in]	account	The account handle
[out]	sync_support	The sync support

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_set_sync_support()

Gets the count of accounts in the account database.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read

Parameters:

[out]

count

The out parameter for count of all accounts

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

Gets the user integer.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	user_int_index	The index of the user integer (must be in range from 0 to 4)
[out]	user_integer	The user integer

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_set_user_int()

Gets the user name of an account.

Since :

2.3

Remarks:

You must release user_name using free().

Parameters:

[in]	account	The account handle
[out]	user_name	The user name of the account

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of memory
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_set_user_name()

Gets the user text.

Since :

2.3

Remarks:

You must release user_text using free().

Parameters:

[in]	account	The account handle
[in]	user_text_index	The index of the user text (range: 0 ~ 4)
[out]	user_text	The user text

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of memory
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_set_user_text()

Inserts the account details to the account database.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read
http://tizen.org/privilege/account.write

Remarks:

This API need both privileges

Parameters:

[in]	account	The account handle
[out]	account_db_id	The account ID to be assigned to an account

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of Memory
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_DUPLICATED	Same user name exists in your application
ACCOUNT_ERROR_NOT_ALLOW_MULTIPLE	Tried to add an account in spite of multiple false accounts
ACCOUNT_ERROR_NOT_REGISTERED_PROVIDER	Tried to add an account though you did not register the account type in manifest
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

See also:

account_delete_from_db_by_id()

account_delete_from_db_by_user_name()

account_delete_from_db_by_package_name()

account_update_to_db_by_id()

account_update_to_db_by_user_name()

Retrieves an account with the account ID.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read

Remarks:

You must allocate account using account_create() and release using account_destroy().

Parameters:

[in]	account_db_id	The account database ID to search
[out]	account	The account handle

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of Memory
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

See also:

account_query_account_by_user_name()

account_query_account_by_package_name()

account_query_account_by_capability()

Retrieves all accounts with the capability type and capability value.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read

Parameters:

[in]	callback	The callback function to invoke
[in]	capability_type	The capability type to search
[in]	capability_value	The capability value to search
[in]	user_data	The user data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of Memory
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

Postcondition:

This function invokes account_cb().

See also:

account_foreach_account_from_db()

account_query_account_by_account_id()

account_query_account_by_user_name()

account_query_account_by_package_name()

Retrieves all accounts with the capability type.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read

Parameters:

[in]	callback	The callback function to invoke
[in]	capability_type	The capability type to search
[in]	user_data	The user data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of Memory
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

Postcondition:

This function invokes account_cb().

See also:

account_foreach_account_from_db()

account_query_account_by_account_id()

account_query_account_by_user_name()

account_query_account_by_package_name()

Retrieves all accounts with the package name.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read

Parameters:

[in]	callback	The callback function to invoke
[in]	package_name	The package name to search
[in]	user_data	The user data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of Memory
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

Postcondition:

This function invokes account_cb().

See also:

account_foreach_account_from_db()

account_query_account_by_account_id()

account_query_account_by_user_name()

account_query_account_by_capability()

Retrieves all accounts with the user name.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read

Parameters:

[in]	callback	The callback function to invoke
[in]	user_name	The user name to search
[in]	user_data	The user data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of Memory
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

Postcondition:

This function invokes account_cb().

See also:

account_foreach_account_from_db()

account_query_account_by_account_id()

account_query_account_by_package_name()

account_query_account_by_capability()

Retrieves all capabilities with the account database ID.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read

Parameters:

[in]	callback	The callback function to invoke
[in]	account_db_id	The account database ID to search
[in]	user_data	The user data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of Memory
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

Postcondition:

This function invokes capability_cb().

See also:

account_get_capability()

account_set_capability()

Sets the access token. Access token field is used to store account secrets (such as password or master token).

Since :

2.3

Remarks:

Only account owner application can retrieve account password / access_token. For others this field will be null.

Parameters:

[in]	account	The account handle
[in]	access_token	The text string to set as the access token

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_get_access_token()

Sets the authentiacation type.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	auth_type	The integer to be set as the authentiacation type

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_get_auth_type()

Sets the capability.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	capability_type	The capability type
[in]	capability_state	The capability state

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_get_capability()

Sets the custom.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	key	The user custom key for the specific value
[in]	value	The user custom value about the given key

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_get_custom()

Sets the display name of an account.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	display_name	The text string to set as the display name

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_get_display_name()

Sets the domain name.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	domain_name	The text string to set as the domain name

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_get_domain_name()

Sets the email address.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	email_address	The text string to set as the email address

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_get_email_address()

Sets the icon path.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	icon_path	The text string to set as the icon path

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_get_icon_path()

Sets the package name.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	package_name	The text string to set as the package name

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_get_email_address()

Sets the secret.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	secret	The secrecy to be set

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_get_secret()

Sets the source.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	source	The text string to set as the source

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_get_source()

Sets the sync support.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	sync_support	The sync state to be set

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_get_sync_support()

Sets the user integer.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	user_int_index	The index of the user integer (must be in range from 0 to 4)
[in]	user_integer	The integer to set as the user integer

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_get_user_int()

Sets the user name of an account.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	user_name	The string to set as user name

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_get_user_name()

Sets the user text.

Since :

2.3

Parameters:

[in]	account	The account handle
[in]	user_text_index	The index of the user text (must be in range from 0 to 4)
[in]	user_text	The text string to set as the user text

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_get_user_text()

Creates a handle for the account event subscription.

Since :

2.3

Remarks:

You must release account_subscribe handle using account_unsubscribe_notification().

Parameters:

[in]

account_subscribe

The account subscription handle

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of Memory
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_unsubscribe_notification()

account_subscribe_notification()

Starts to subscribe account event through the given callback function.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read

Parameters:

[in]	account_subscribe	The account subscription handle
[in]	callback	The callback function that is called when an account is removed and a data of account is updated from the account database It will be called with event message and account ID.
[in]	user_data	The user_data that is delivered to callback

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_EVENT_SUBSCRIPTION_FAIL	Subscription fail
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

account_subscribe_create()

See also:

account_unsubscribe_notification()

account_subscribe_notification()

Creates a handle to the account provider.

Since :

2.3

Remarks:

You must release account_type handle using account_type_destroy().

Parameters:

[in]

account_type

The account provider handle

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of Memory
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_type_destroy()

Destroys the account provider handle and releases all its resources.

Since :

2.3

Remarks:

When you get account_type_h using account_type_create(), you must release the handle using account_destroy() to avoid the memory leak.

Parameters:

[in]

account_type

The account provider handle

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_type_create()

Retrieves all account priovider information.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read

Parameters:

[in]	callback	The account provider information You can get the account information through account_type_get_* with the carried account_type_handle.
[in]	user_data	The user data It will be carried through your callback function.

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

See also:

account_type_create()

account_type_get_app_id()

account_type_get_service_provider_id()

account_type_get_icon_path()

account_type_get_small_icon_path()

account_type_get_multiple_account_support()

account_type_get_label()

account_type_destroy()

Gets the application ID of an account provider.

Since :

2.3

Remarks:

You must release app_id using free().

Parameters:

[in]	account_type	The account provider handle It should be given by account_type_query_* functions or account_type_foreach_account_type_from_db().
[out]	app_id	The application ID of an account provider item

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of memory
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_type_foreach_account_type_from_db()

account_type_query_by_app_id()

Gets the icon path of an account provider.

Since :

2.3

Remarks:

You must release icon_path using free().

Parameters:

[in]	account_type	The account provider handle It should be given by account_type_query_* functions or account_type_foreach_account_type_from_db().
[out]	icon_path	The icon path of the account provider item

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of memory
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_type_foreach_account_type_from_db()

account_type_query_by_app_id()

Gets the label information detail of an account provider.

Since :

2.3

Parameters:

[in]	account_type	The account provider handle It should be given by account_type_query_* functions or account_type_foreach_account_type_from_db().
[in]	callback	The callback function carrying the label information
[in]	user_data	The user data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_type_foreach_account_type_from_db()

account_type_query_by_app_id()

Gets the specific label information detail of an account provider.

Since :

2.3

Remarks:

You must release label using free().

Parameters:

[in]	account_type	The account provider handle It should be given by account_type_query_* functions or account_type_foreach_account_type_from_db().
[in]	locale	The locale is specified as an ISO 3166 alpha-2 two letter country-code followed by ISO 639-1 for the two-letter language code. For example, "ko_KR" or "ko-kr" for Korean, "en_US" or "en-us" for American English.
[out]	label	The label text given for the locale

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_RECORD_NOT_FOUND	No label for the given locale
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_type_foreach_account_type_from_db()

account_type_query_by_app_id()

Checks whether the given account provider supports multiple accounts.

Since :

2.3

Parameters:

[in]	account_type	The account provider handle It should be given by account_type_query_* functions or account_type_foreach_account_type_from_db.
[out]	multiple_account_support	The flag indicating support for multiple accounts accounts TRUE or FALSE.

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of memory
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_type_foreach_account_type_from_db()

account_type_query_by_app_id()

Gets capability information with the given account provider handle.

Since :

2.3

Parameters:

[in]	account_type	The account provider handle It should be given by account_type_query_* functions or account_type_foreach_account_type_from_db().
[in]	callback	The callback function that carries the capability name of the app ID
[in]	user_data	The user data If you have your private data to carry into callback function, then you can use it.

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

Gets the service provider ID of an account provider.

Since :

2.3

Remarks:

You must release service_provider_id using free().

Parameters:

[in]	account_type	The account provider handle It should be given by account_type_query_* functions or account_type_foreach_account_type_from_db().
[out]	service_provider_id	The service provider text ID of an account provider item

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of memory
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_type_foreach_account_type_from_db()

account_type_query_by_app_id()

Gets the small icon path of an account provider.

Since :

2.3

Remarks:

You must release small_icon_path using free().

Parameters:

[in]	account_type	The account provider handle It should be given by account_type_query_* functions or account_type_foreach_account_type_from_db().
[out]	small_icon_path	The small icon path of the account provider item

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_OUT_OF_MEMORY	Out of memory
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

See also:

account_type_foreach_account_type_from_db()

account_type_query_by_app_id()

Checks whether the given app_id exists in the account provider DB.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read

Parameters:

[in]

app_id

The application ID to check

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_RECORD_NOT_FOUND	Record not found
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid app ID
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

See also:

account_type_query_by_app_id()

Retrieves the account provider information with your application ID.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read

Parameters:

[in]	app_id	The application ID to search
[in,out]	account_type	The account handle which has to be created by account_type_create() before calling this function and released by account_type_destroy() after calling this function.

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_RECORD_NOT_FOUND	Queried data does not exist
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

See also:

account_type_create()

account_type_get_app_id()

account_type_get_service_provider_id()

account_type_get_icon_path()

account_type_get_small_icon_path()

account_type_get_multiple_account_support()

account_type_get_label()

account_type_destroy()

Retrieves account provider information with the capability name.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read

Parameters:

[in]	callback	The callback function to retrieve account provider information
[in]	key	The capability value to search account provider For example, ACCOUNT_SUPPORTS_CAPABILITY_CONTACT or "http://tizen.org/account/capability/contact"
[in]	user_data	If you have your private data to carry into callback function, then you can use it

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_RECORD_NOT_FOUND	Record not found
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported

Precondition:

This function requires an open connection to an account service by account_connect() on tizen 2.3 (MOBILE).
But the account_connect() is not required to use this function since tizen 2.4.

Retrieves the label information with your application ID.

Since :

2.3

Privilege Level:

public

Privilege:

http://tizen.org/privilege/account.read

Parameters:

[in]	callback	The callback function that carries label_h for label information label_h contains label info as parameter.
[in]	app_id	The application ID to search
[in]	user_data	The user data If you have your private data to carry into callback function, then you can use it.

Returns:

0 on success, otherwise a negative error value

Return values:

ACCOUNT_ERROR_NONE	Successful
ACCOUNT_ERROR_INVALID_PARAMETER	Invalid parameter
ACCOUNT_ERROR_DB_FAILED	Database operation failed
ACCOUNT_ERROR_PERMISSION_DENIED	DB Access fail by permission
ACCOUNT_ERROR_DATABASE_BUSY	SQLite handler is busy
ACCOUNT_ERROR_DB_NOT_OPENED	Account database did not opened
ACCOUNT_ERROR_NOT_SUPPORTED	Not supported