/**
- * @brief Called when a response is received for a bulk operation from a provider application.
+ * @brief Called when a response is received for a bulk operation from a provider application.
* @since_tizen 3.0
*
* @param[in] request_id The request ID
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
*/
int data_control_bulk_data_add(data_control_bulk_data_h bulk_data, bundle *data);
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
*/
int data_control_bulk_data_create(data_control_bulk_data_h *bulk_data);
/**
- * @brief Adds bulk data
+ * @brief Adds bulk data.
* @since_tizen 3.0
* @remarks The order in which bundles are added is preserved. Bundle indexes start from 0.
* @param[in] result_data The bulk result data handle
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
* @see data_control_bulk_result_data_get_result_data()
*/
int data_control_bulk_result_data_add(data_control_bulk_result_data_h result_data, bundle *data, int result);
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
*/
int data_control_bulk_result_data_create(data_control_bulk_result_data_h *result_data);
/**
* @brief Called when the result value list is received from the key-value structured data control provider.
* @since_tizen 2.3
- * @remarks You must release @a result_value_list using free() after it is used. Note that @a result_value list is an array of char *. Its length is @a result_value_count. You should release all the elements in the @a result_value_list array and @a result_value_list itself like the following code.
+ * @remarks You must release @a result_value_list using free() after it is used. Note that @a result_value_list is an array of char *. Its length is @a result_value_count. You should release all the elements in the @a result_value_list array and @a result_value_list itself like the following code.
*
* @code
*
* @since_tizen 2.3
*
* @remarks The application is notified when a data control response is received from the @a provider.
- * @remarks Only one callback can be registered for each provider id with this API.
+ * @remarks Only one callback can be registered for each provider id with this function.
* @remarks If you register multiple callback for same provider id, it will be overwritten by latest one.
*
* @param[in] provider The provider handle
* @privlevel public
* @privilege %http://tizen.org/privilege/datasharing \n
* %http://tizen.org/privilege/appmanager.launch
- * @remarks If you want to use this api, you must add privileges.
- * @remarks If the length of value list associated with the @a key is larger than 20, this API only returns the first 20 values.
+ * @remarks If you want to use this function, you must add privileges.
+ * @remarks If the length of value list associated with the @a key is larger than 20, this function only returns the first 20 values.
* @remarks The following example demonstrates how to use the %data_control_map_get() method.
*
* @code
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
* @retval #DATA_CONTROL_ERROR_MAX_EXCEEDED Too long argument
- * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @see data_control_map_get_with_page()
*/
int data_control_map_get(data_control_h provider, const char *key, int *request_id);
* @privilege %http://tizen.org/privilege/datasharing \n
* %http://tizen.org/privilege/appmanager.launch
*
- * @remarks If you want to use this api, you must add privileges.
+ * @remarks If you want to use this function, you must add privileges.
* @param[in] provider The provider handle
* @param[in] key The key of the value list to obtain
* @param[out] request_id The request ID
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
* @retval #DATA_CONTROL_ERROR_MAX_EXCEEDED Too long argument
- * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @see data_control_map_get()
*/
int data_control_map_get_with_page(data_control_h provider, const char *key, int *request_id, int page_number, int count_per_page);
* @privlevel public
* @privilege %http://tizen.org/privilege/datasharing \n
* %http://tizen.org/privilege/appmanager.launch
- * @remarks If you want to use this api, you must add privileges.
+ * @remarks If you want to use this function, you must add privileges.
* @remarks The following example demonstrates how to use the %data_control_map_set() method.
*
* @code
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
* @retval #DATA_CONTROL_ERROR_MAX_EXCEEDED Too long argument
- * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
*/
int data_control_map_set(data_control_h provider, const char *key, const char *old_value, const char *new_value, int *request_id);
* @privlevel public
* @privilege %http://tizen.org/privilege/datasharing \n
* %http://tizen.org/privilege/appmanager.launch
- * @remarks If you want to use this api, you must add privileges.
+ * @remarks If you want to use this function, you must add privileges.
* @remarks The following example demonstrates how to use the %data_control_map_add() method.
*
* @code
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
* @retval #DATA_CONTROL_ERROR_MAX_EXCEEDED Too long argument
- * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
*/
int data_control_map_add(data_control_h provider, const char *key, const char *value, int *request_id);
* @privlevel public
* @privilege %http://tizen.org/privilege/datasharing \n
* %http://tizen.org/privilege/appmanager.launch
- * @remarks If you want to use this api, you must add privileges.
+ * @remarks If you want to use this function, you must add privileges.
* @remarks The following example demonstrates how to use the %data_control_map_remove() method.
*
* @code
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
* @retval #DATA_CONTROL_ERROR_MAX_EXCEEDED Too long argument
- * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
*/
int data_control_map_remove(data_control_h provider, const char *key, const char *value, int *request_id);
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
* @retval #DATA_CONTROL_ERROR_MAX_EXCEEDED Too long argument. Bulk data total length cannot exceed 1MB
- * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
*/
int data_control_map_add_bulk_data(data_control_h provider, data_control_bulk_data_h bulk_data, int *request_id);
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @see data_control_map_unregister_add_bulk_data_response_cb()
* @see data_control_map_bind_add_bulk_data_response_cb()
*/
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @see data_control_map_register_response_cb()
* @see data_control_map_unbind_response_cb()
*/
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @see data_control_map_register_add_bulk_data_response_cb()
* @see data_control_map_unbind_add_bulk_data_response_cb()
*/
* @param[in] data Data from provider, intended to contain information about changed data \n
* @a data is valid only inside this function \n
* To use outside the callback, make a copy. @a data should not be freed
- * @param[in] user_data The user data passed from the add function
+ * @param[in] user_data The user data passed from the add function
* @pre The callback must be registered using data_control_add_data_change_cb(). \n
* data_control_provider_send_data_change_noti() must be called to invoke this callback.
* @see data_control_add_data_change_cb()
- * @see data_control_provider_send_data_change_noti()
+ * @see data_control_provider_send_data_change_noti()
*/
typedef void (*data_control_data_change_cb) (data_control_h provider, data_control_data_change_type_e type, bundle *data, void *user_data);
* #DATA_CONTROL_ERROR_PERMISSION_DENIED, \n
* #DATA_CONTROL_ERROR_MAX_EXCEEDED
* @since_tizen 3.0
- * @remarks DATA_CONTROL_ERROR_PERMISSION_DENIED will be returned when the provider denies to add the callback.
+ * @remarks #DATA_CONTROL_ERROR_PERMISSION_DENIED will be returned when the provider denies to add the callback.
* @param[in] provider The provider handle. @a provider is valid only inside this function \n
* @a provider should not be destroyed.
* @param[in] result Add data change callback result
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @see data_control_data_change_cb()
* @see data_control_add_callback_result_cb()
* @see data_control_provider_add_data_change_consumer_filter_cb()
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
*/
int data_control_remove_data_change_cb(data_control_h provider, int callback_id);
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
- * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
*/
int data_control_provider_sql_register_cb(data_control_provider_sql_cb *callback, void *user_data);
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
- * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
*/
int data_control_provider_map_register_cb(data_control_provider_map_cb *callback, void *user_data);
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
*/
int data_control_provider_get_client_appid(int request_id, char **appid);
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
*/
int data_control_provider_send_select_result(int request_id, void *db_handle);
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
*/
int data_control_provider_send_insert_result(int request_id, long long row_id);
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
*/
int data_control_provider_send_update_result(int request_id);
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
*/
int data_control_provider_send_delete_result(int request_id);
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
*/
int data_control_provider_send_error(int request_id, const char *error);
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
*/
int data_control_provider_send_map_result(int request_id);
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
*/
int data_control_provider_send_map_get_value_result(int request_id, char **value_list, int value_count);
*
* @return The SQL INSERT statement on success,
* otherwise NULL
- * @exception DATA_CONTROL_ERROR_NONE Success
- * @exception DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @exception DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @exception #DATA_CONTROL_ERROR_NONE Success
+ * @exception #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @exception #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
*/
char *data_control_provider_create_insert_statement(data_control_h provider, bundle *insert_map);
*
* @return The SQL DELETE statement on success,
* otherwise NULL
- * @exception DATA_CONTROL_ERROR_NONE Success
- * @exception DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @exception DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @exception #DATA_CONTROL_ERROR_NONE Success
+ * @exception #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @exception #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
*/
char *data_control_provider_create_delete_statement(data_control_h provider, const char *where);
*
* @return The SQL UPDATE statement on success,
* otherwise NULL
- * @exception DATA_CONTROL_ERROR_NONE Success
- * @exception DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @exception DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @exception #DATA_CONTROL_ERROR_NONE Success
+ * @exception #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @exception #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
*/
char *data_control_provider_create_update_statement(data_control_h provider, bundle *update_map, const char *where);
*
* @return The SQL SELECT statement on success,
* otherwise NULL
- * @exception DATA_CONTROL_ERROR_NONE Success
- * @exception DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @exception DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @exception #DATA_CONTROL_ERROR_NONE Success
+ * @exception #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @exception #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
*/
char *data_control_provider_create_select_statement(data_control_h provider, const char **column_list, int column_count, const char *where, const char *order);
*
* @return @c true if the provider_id matches,
* otherwise @c false if it does not match
- * @exception DATA_CONTROL_ERROR_NONE Success
- * @exception DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @exception DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @exception #DATA_CONTROL_ERROR_NONE Success
+ * @exception #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @exception #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
*/
bool data_control_provider_match_provider_id(data_control_h provider, const char *provider_id);
*
* @return @c true if the @a data_id matches,
* otherwise @c false if it does not match
- * @exception DATA_CONTROL_ERROR_NONE Success
- * @exception DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @exception DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @exception #DATA_CONTROL_ERROR_NONE Success
+ * @exception #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @exception #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
*/
bool data_control_provider_match_data_id(data_control_h provider, const char *data_id);
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
*
* @pre The consumer should call data_control_add_data_change_cb() to receive data change notifications
* @see data_control_data_change_cb()
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
* @see data_control_provider_data_change_consumer_filter_cb()
*/
int data_control_provider_add_data_change_consumer_filter_cb(data_control_provider_data_change_consumer_filter_cb callback, void *user_data, int *callback_id);
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @post This function invokes data_control_provider_data_change_consumer_cb().
* @see data_control_provider_data_change_consumer_cb()
*/
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
*/
int data_control_provider_send_bulk_insert_result(int request_id, data_control_bulk_result_data_h bulk_results);
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
*/
int data_control_provider_send_map_bulk_add_result(int request_id, data_control_bulk_result_data_h bulk_results);
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
*/
int data_control_provider_sql_register_insert_bulk_data_request_cb(data_control_provider_bulk_cb callback, void *user_data);
/**
- * @brief Unregisters the callback for the SQL bulk data request.
+ * @brief Unregisters the callback for the SQL bulk data request.
* @since_tizen 3.0
*
* @return @c 0 on success,
/**
- * @brief Registers a callback for the MAP bulk data request.
- * @details The provider is notified when a data control request is received from the client applications.
+ * @brief Registers a callback for the MAP bulk data request.
+ * @details The provider is notified when a data control request is received from the client applications.
* @since_tizen 3.0
- * @privlevel public
- * @privilege %http://tizen.org/privilege/datasharing
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/datasharing
*
* @param[in] callback The callback function to be called when a data control request is received
* @param[in] user_data The user data to be passed to the callback function
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
*/
int data_control_provider_map_register_add_bulk_data_request_cb(data_control_provider_bulk_cb callback, void *user_data);
/**
- * @brief Unregisters the callback for the MAP bulk data request.
+ * @brief Unregisters the callback for the MAP bulk data request.
* @since_tizen 3.0
*
* @return @c 0 on success,
*/
/**
- * @file data-control-provider.h
- * @brief This is the header file for the data control provider.
+ * @file data-control-provider.h
+ * @brief This is the header file for the data control provider.
*/
#ifndef _APPFW_DATA_CONTROL_PROVIDER_H_
/**
* @brief Sends select result without selected data.
- * @details This API is made for C# API. C# API has a different select flow. \n
- * It will send select result after provider's select callback and \n
- * do not get db handle for sending result to remove db dependancy. \n
- * So, this API just send provider's select callback result and pass \n
- * connected socket fd for sending selected data to consumer.
+ * @details This function is made for C# API. C# API has a different select flow. \n
+ * It will send select result after provider's select callback and \n
+ * do not get db handle for sending result to remove db dependancy. \n
+ * So, this function just send provider's select callback result and pass \n
+ * connected socket fd for sending selected data to consumer.
*
- * @param[in] request_id The request ID
- * @param[out] fd The socket fd
+ * @param[in] request_id The request ID
+ * @param[out] fd The socket fd
*
* @return @c 0 on success,
* otherwise a negative error value
*
* @retval #DATACONTROL_ERROR_NONE Successful
+ * @retval #DATACONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATACONTROL_ERROR_IO_ERROR I/O error
* @retval #DATACONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATACONTROL_ERROR_INVALID_PARAMETER Invalid parameter
*/
-EXPORT_API int datacontrol_provider_send_select_result_without_data(int request_id, int *fd);
+int datacontrol_provider_send_select_result_without_data(int request_id, int *fd);
/**
- * @brief Writes data to socket.
- * @details This API is made for C# API. C# API has a different select flow. \n
- * It will send select result after provider's select callback and \n
- * do not get db handle for sending result to remove db dependancy. \n
- * So, C# API need native API which get buffer and send it to the consumer.
+ * @brief Writes data to socket.
+ * @details This function is made for C# API. C# API has a different select flow. \n
+ * It will send select result after provider's select callback and \n
+ * do not get db handle for sending result to remove db dependancy. \n
+ * So, C# API need native API which get buffer and send it to the consumer.
*
- * @param[in] fd The socket fd
- * @param[in] buffer The data for sending to the consumer application
- * @param[in] nbytes The data size
- * @param[out] bytes_write The data size of sent successfully to the consumer
+ * @param[in] fd The socket fd
+ * @param[in] buffer The data for sending to the consumer application
+ * @param[in] nbytes The data size
+ * @param[out] bytes_write The data size of sent successfully to the consumer
*
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATACONTROL_ERROR_NONE Successful
* @retval #DATACONTROL_ERROR_IO_ERROR I/O error
*/
-EXPORT_API int datacontrol_provider_write_socket(int fd, void *buffer, unsigned int nbytes,
+int datacontrol_provider_write_socket(int fd, void *buffer, unsigned int nbytes,
unsigned int *bytes_write);
/**
- * @brief Gets select request page info.
- * @details This API is made for C# API. C# API can control selected page in proivder's callback. \n
- * This API provide request page info to the provider application so that provider application \n
- * can manage which page should be sent to the consumer.
+ * @brief Gets select request page info.
+ * @details This function is made for C# API. C# API can control selected page in proivder's callback. \n
+ * This function provide request page info to the provider application so that provider application \n
+ * can manage which page should be sent to the consumer.
*
- * @param[in] request_id The request ID
- * @param[out] page_num The requested page number
- * @param[out] count_per_page The requested count per page
+ * @param[in] request_id The request ID
+ * @param[out] page_num The requested page number
+ * @param[out] count_per_page The requested count per page
*
* @return @c 0 on success,
* otherwise a negative error value
*
* @retval #DATACONTROL_ERROR_NONE Successful
- * @retval #DATACONTROL_ERROR_IO_ERROR I/O error
* @retval #DATACONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATACONTROL_ERROR_IO_ERROR I/O error
*/
-EXPORT_API int datacontrol_provider_get_select_page_info(int request_id, int *page_num, int *count_per_page);
+int datacontrol_provider_get_select_page_info(int request_id, int *page_num, int *count_per_page);
#ifdef __cplusplus
}
* @since_tizen 2.3
*
* @remarks The application is notified when a data control response is received from the @a provider.
- * @remarks Only one callback can be registered for each provider id with this API.
+ * @remarks Only one callback can be registered for each provider id with this function.
* @remarks If you register multiple callback for same provider id, it will be overwritten by latest one.
*
*
* @privilege %http://tizen.org/privilege/datasharing \n
* %http://tizen.org/privilege/appmanager.launch
*
- * @remarks If you want to use this api, you must add privileges.
+ * @remarks If you want to use this function, you must add privileges.
* @remarks If the value is a string, then the value must be wrapped in single quotes, else it does not need to be wrapped in single quotes.
* @remarks The following example demonstrates how to use the %data_control_sql_delete() method:
*
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
*/
int data_control_sql_delete(data_control_h provider, const char *where, int *request_id);
* @privilege %http://tizen.org/privilege/datasharing \n
* %http://tizen.org/privilege/appmanager.launch
*
- * @remarks If you want to use this api, you must add privileges.
- * @remarks The following example demonstrates how to use the %data_control_sql_insert() method:
+ * @remarks If you want to use this function, you must add privileges.
+ * The following example demonstrates how to use the %data_control_sql_insert() method:
*
* @code
*
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_MAX_EXCEEDED Too long argument
*/
int data_control_sql_insert(data_control_h provider, const bundle *insert_data, int *request_id);
* @privilege %http://tizen.org/privilege/datasharing \n
* %http://tizen.org/privilege/appmanager.launch
*
- * @remarks If you want to use this api, you must add privileges.
+ * @remarks If you want to use this function, you must add privileges.
* @remarks The following example demonstrates how to use the %data_control_sql_select() method:
*
* @code
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
*/
int data_control_sql_select(data_control_h provider, char **column_list, int column_count, const char *where, const char *order, int *request_id);
* @privilege %http://tizen.org/privilege/datasharing \n
* %http://tizen.org/privilege/appmanager.launch
*
- * @remarks If you want to use this api, you must add privileges.
+ * @remarks If you want to use this function, you must add privileges.
*
* @param[in] provider The provider handle
* @param[in] column_list The column list to query
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @see data_control_sql_select()
*/
int data_control_sql_select_with_page(data_control_h provider, char **column_list, int column_count, const char *where, const char *order, int page_number, int count_per_page, int *request_id);
* @privilege %http://tizen.org/privilege/datasharing \n
* %http://tizen.org/privilege/appmanager.launch
*
- * @remarks If you want to use this api, you must add privileges.
- * @remarks The following example demonstrates how to use the %data_control_sql_update() method:
+ * @remarks If you want to use this function, you must add privileges.
+ * The following example demonstrates how to use the %data_control_sql_update() method:
*
* @code
*
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_MAX_EXCEEDED Too long argument
*/
int data_control_sql_update(data_control_h provider, const bundle *update_data, const char *where, int *request_id);
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_PERMISSION_DENIED Permission denied
* @retval #DATA_CONTROL_ERROR_MAX_EXCEEDED Too long argument
*/
int data_control_sql_insert_bulk_data(data_control_h provider, data_control_bulk_data_h bulk_data, int *request_id);
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
*
* @see data_control_sql_unregister_insert_bulk_data_response_cb()
* @see data_control_sql_bind_insert_bulk_data_response_cb()
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @see data_control_sql_register_response_cb()
* @see data_control_sql_unbind_response_cb()
*/
* otherwise a negative error value
*
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
*
* @see data_control_sql_register_insert_bulk_data_response_cb()
* @see data_control_sql_unbind_insert_bulk_data_response_cb()
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
- * @see data_control_sql_unbind_insert_bulk_data_response_cb()
+ * @see data_control_sql_bind_insert_bulk_data_response_cb()
*/
int data_control_sql_unbind_insert_bulk_data_response_cb(
data_control_h provider);
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
*/
int data_control_sql_step_first(result_set_cursor cursor);
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
*/
int data_control_sql_step_last(result_set_cursor cursor);
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
*/
int data_control_sql_step_next(result_set_cursor cursor);
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
*/
int data_control_sql_get_column_name(result_set_cursor cursor, int column_index, char *name);
* @param[in] column_index The index of the destination column
* @return The size of data in the column indicated by the specified index \n
* If an error is occurred, then a negative value is returned
- * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
*/
int data_control_sql_get_column_item_size(result_set_cursor cursor, int column_index);
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
*/
int data_control_sql_get_column_item_type(result_set_cursor cursor, int column_index, data_control_sql_column_type_e *type);
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
+ * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
* @retval #DATA_CONTROL_ERROR_MAX_EXCEEDED Too long argument
- * @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
*/
int data_control_sql_get_blob_data(result_set_cursor cursor, int column_index, void *data, int size);
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
*/
int data_control_sql_get_int_data(result_set_cursor cursor, int column_index, int *data);
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
*/
int data_control_sql_get_int64_data(result_set_cursor cursor, int column_index, long long *data);
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
*/
int data_control_sql_get_double_data(result_set_cursor cursor, int column_index, double *data);
* @return @c 0 on success,
* otherwise a negative error value
* @retval #DATA_CONTROL_ERROR_NONE Successful
- * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #DATA_CONTROL_ERROR_IO_ERROR I/O error
* @retval #DATA_CONTROL_ERROR_OUT_OF_MEMORY Out of memory
*/
int data_control_sql_get_text_data(result_set_cursor cursor, int column_index, char *data);
return ret;
}
-int datacontrol_provider_write_socket(
+EXPORT_API int datacontrol_provider_write_socket(
int fd, void *buffer, unsigned int nbytes,
unsigned int *bytes_write)
{
return ret;
}
-int datacontrol_provider_send_select_result_without_data(
+EXPORT_API int datacontrol_provider_send_select_result_without_data(
int request_id, int *fd)
{
int ret;
return ret;
}
-int datacontrol_provider_get_select_page_info(
+EXPORT_API int datacontrol_provider_get_select_page_info(
int request_id, int *page_num, int *count_per_page)
{
bundle *b;