diff options
author | Abhay Agarwal <ay.agarwal@samsung.com> | 2021-01-28 16:10:50 +0530 |
---|---|---|
committer | Abhay Agarwal <ay.agarwal@samsung.com> | 2021-01-28 17:00:06 +0530 |
commit | b4b2bdf09ae75e82c97fd8db5ce87c602fa8220f (patch) | |
tree | 153aaf875dd24b8bd35d96c971c080f7783a311a | |
parent | 26cb7eb9e732747ad85af8cbf74765edc30e8c54 (diff) | |
download | user-awareness-b4b2bdf09ae75e82c97fd8db5ce87c602fa8220f.tar.gz user-awareness-b4b2bdf09ae75e82c97fd8db5ce87c602fa8220f.tar.bz2 user-awareness-b4b2bdf09ae75e82c97fd8db5ce87c602fa8220f.zip |
Update API description for return error code
Update API desciption to add UA_ERROR_NOT_INITIALIZED error code.
Change-Id: I70806f36c63bee4f9df5c7d276dcc8672406ccdd
Signed-off-by: Abhay Agarwal <ay.agarwal@samsung.com>
-rwxr-xr-x | include/user-awareness-internal.h | 26 | ||||
-rwxr-xr-x | include/user-awareness.h | 159 | ||||
-rwxr-xr-x | src/user-awareness-event-handler.c | 2 |
3 files changed, 138 insertions, 49 deletions
diff --git a/include/user-awareness-internal.h b/include/user-awareness-internal.h index c3d9a48..681cb98 100755 --- a/include/user-awareness-internal.h +++ b/include/user-awareness-internal.h @@ -96,6 +96,7 @@ typedef bool (*ua_service_added_device_cb)( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OUT_OF_MEMORY Out of memory + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -121,6 +122,7 @@ int ua_user_clone(ua_user_h *cloned, ua_user_h origin) TIZEN_DEPRECATED_API; * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -144,6 +146,7 @@ int ua_user_get_default_user(ua_user_h *user_handle) TIZEN_DEPRECATED_API; * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -165,6 +168,7 @@ int ua_get_default_user(ua_user_h *user_handle); * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -186,6 +190,7 @@ int ua_user_set_account(ua_user_h user_handle, const char *account) TIZEN_DEPREC * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -206,6 +211,7 @@ int ua_user_set_name(ua_user_h user_handle, const char *name) TIZEN_DEPRECATED_A * @retval #UA_ERROR_NONE Successful * @retcal #UA_ERROR_RESOURCE_BUSY Remove done. but another service uses thie device. * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -227,6 +233,7 @@ int ua_user_remove_device_by_device_id(const char *device_id, ua_mac_type_e mac_ * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OUT_OF_MEMORY Out of memory * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -250,6 +257,7 @@ int ua_user_foreach_added(ua_registered_user_cb foreach_cb, void *user_data) TIZ * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OUT_OF_MEMORY Out of memory * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -273,6 +281,7 @@ int ua_foreach_users( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -295,6 +304,7 @@ int ua_service_add_device(ua_service_h service_handle, ua_device_h device_handle * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -318,6 +328,7 @@ int ua_service_remove_device(ua_service_h service_handle, * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -341,6 +352,7 @@ int ua_service_foreach_added_devices(ua_service_h service_handle, * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -364,6 +376,7 @@ int ua_device_set_discriminant(ua_device_h device_handle, * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OUT_OF_MEMORY Out of memory + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -388,6 +401,7 @@ int ua_device_foreach_added_by_user( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OUT_OF_MEMORY Out of memory + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -412,6 +426,7 @@ int ua_foreach_devices( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet */ int ua_monitor_set_brightness_threshold(ua_monitor_h handle, int presence_threshold, int absence_threshold); @@ -424,6 +439,7 @@ int ua_monitor_set_brightness_threshold(ua_monitor_h handle, * * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet */ int ua_enable_low_power_mode(void); @@ -435,6 +451,7 @@ int ua_enable_low_power_mode(void); * * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet */ int ua_disable_low_power_mode(void); @@ -449,6 +466,7 @@ int ua_disable_low_power_mode(void); * * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet */ int ua_set_low_power_mode(unsigned int bitmask, bool on_off); @@ -470,6 +488,7 @@ int ua_set_low_power_mode(unsigned int bitmask, bool on_off); * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet */ int ua_get_detection_params(int *cycle, int *period, int *retries); @@ -492,6 +511,7 @@ int ua_get_detection_params(int *cycle, int *period, int *retries); * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet */ int ua_set_detection_params(int cycle, int period, int retries); @@ -512,6 +532,7 @@ int ua_set_detection_params(int cycle, int period, int retries); * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @see #UA_DETECTION_CYCLE_STEP * @see #UA_MIN_DETECTION_CYCLE @@ -532,6 +553,7 @@ int ua_set_detection_cycle(ua_service_h service, unsigned int cycle_time); * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @see ua_set_detection_cycle() */ @@ -557,6 +579,7 @@ int ua_get_detection_cycle(ua_service_h service, unsigned int* cycle_time); * @see #UA_DETECTION_WINDOW_STEP * @see #UA_MAX_DETECTION_WINDOW * @see ua_get_detection_window() + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet */ int ua_set_detection_window(unsigned int window); @@ -571,6 +594,7 @@ int ua_set_detection_window(unsigned int window); * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @see ua_set_detection_window() */ @@ -584,6 +608,7 @@ int ua_get_detection_window(unsigned int* window); * * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet */ int ua_reset_database(void); @@ -595,4 +620,3 @@ int ua_reset_database(void); } #endif #endif /* __TIZEN_CAPI_NETWORK_USER_AWARENESS_INTERNAL_H__ */ - diff --git a/include/user-awareness.h b/include/user-awareness.h index fee1e7b..fe19015 100755 --- a/include/user-awareness.h +++ b/include/user-awareness.h @@ -481,6 +481,29 @@ typedef bool (*ua_service_added_user_cb)( void *user_data); /** + * @ingroup CAPI_NETWORK_UA_MODULE + * @brief Callback to be invoked if a new device added to UA. + * @since_tizen 6.5 + * + * @remarks The @a dev_handle should not be released. + * @remarks The @a dev_handle can be used only in the callback. + * + * @param[in] result The result of the requested operation. + * @param[in] dev_handle The added device's handle + * @param[in] user_data The user data passed in ua_user_add_device() + * + * @exception + * @pre + * @post + * + * @see ua_user_add_device() + */ +typedef void (*ua_user_device_added_cb)( + int result, + ua_device_h dev_handle, + void *user_data); + +/** * @brief User info. data structure. * @since_tizen 6.5 */ @@ -566,6 +589,7 @@ int ua_deinitialize(void); * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OUT_OF_MEMORY Out of memory + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -586,6 +610,7 @@ int ua_monitor_create( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -611,6 +636,7 @@ int ua_monitor_destroy( * @retval #UA_ERROR_ALREADY_DONE Already done * @retval #UA_ERROR_NOT_READY Resource not ready * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -638,6 +664,7 @@ int ua_monitor_add_sensor( * @retval #UA_ERROR_ALREADY_DONE Already done * @retval #UA_ERROR_NOT_READY Resource not ready * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -663,6 +690,7 @@ int ua_monitor_remove_sensor( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -688,6 +716,7 @@ int ua_monitor_foreach_sensor( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -713,6 +742,7 @@ int ua_monitor_is_sensor_available( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -733,6 +763,7 @@ int ua_monitor_set_sensor_status_cb( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -763,6 +794,7 @@ int ua_monitor_unset_sensor_status_cb( * @retval #UA_ERROR_NOW_IN_PROGRESS Operation now in progress * @retval #UA_ERROR_NO_DATA No sensor available * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -790,6 +822,7 @@ int ua_monitor_start_scan( * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_NOT_IN_PROGRESS Operation not in progress * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -824,6 +857,7 @@ int ua_monitor_stop_scan(ua_monitor_h monitor); * @retval #UA_ERROR_NOW_IN_PROGRESS Operation now in progress * @retval #UA_ERROR_NO_DATA No sensor available * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -851,6 +885,7 @@ int ua_monitor_start_presence_detection( * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_NOT_IN_PROGRESS Operation not in progress * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -885,6 +920,7 @@ int ua_monitor_stop_presence_detection( * @retval #UA_ERROR_NOW_IN_PROGRESS Operation now in progress * @retval #UA_ERROR_NO_DATA No sensor available * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -912,6 +948,7 @@ int ua_monitor_start_absence_detection( * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_NOT_IN_PROGRESS Operation not in progress * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -936,6 +973,7 @@ int ua_monitor_stop_absence_detection( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OUT_OF_MEMORY Out of memory + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -958,6 +996,7 @@ int ua_user_create(const char *account, * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -979,6 +1018,7 @@ int ua_user_destroy( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -999,6 +1039,7 @@ int ua_user_add(ua_user_h user_handle); * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1021,6 +1062,7 @@ int ua_user_remove( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1069,6 +1111,7 @@ int ua_user_get_information(ua_user_h user_handle, * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1080,53 +1123,6 @@ int ua_user_get_handle_by_account(const char* account, /** * @ingroup CAPI_NETWORK_UA_MODULE - * @brief Gets user handle by account. - * @since_tizen 6.5 - * - * @remarks The @a user_handle should not be released. - * @remarks The @a user_handle can be used only in the function. - * - * @param[in] service_handle The service handle - * @param[in] account The user account information - * @param[out] user_handle The user handle - * - * @return 0 on success, otherwise a negative error value - * @retval #UA_ERROR_NONE Successful - * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter - * - * @exception - * @pre - * @post - * - */ -int ua_service_get_user_by_account(ua_service_h service_handle, - const char* account, ua_user_h *user_handle); - -/** - * @ingroup CAPI_NETWORK_UA_MODULE - * @brief Callback to be invoked if a new device added to UA. - * @since_tizen 6.5 - * - * @remarks The @a dev_handle should not be released. - * @remarks The @a dev_handle can be used only in the callback. - * - * @param[in] result The result of the requested operation. - * @param[in] dev_handle The added device's handle - * @param[in] user_data The user data passed in ua_user_add_device() - * - * @exception - * @pre - * @post - * - * @see ua_user_add_device() - */ -typedef void (*ua_user_device_added_cb)( - int result, - ua_device_h dev_handle, - void *user_data); - -/** - * @ingroup CAPI_NETWORK_UA_MODULE * @brief Adds device for a user. * @since_tizen 6.5 * @@ -1138,6 +1134,7 @@ typedef void (*ua_user_device_added_cb)( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1165,6 +1162,7 @@ int ua_user_add_device( * @retcal #UA_ERROR_RESOURCE_BUSY Remove done. but another service uses thie device. * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1189,6 +1187,7 @@ int ua_user_remove_device( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OUT_OF_MEMORY Out of memory + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1215,6 +1214,7 @@ int ua_user_foreach_devices( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OUT_OF_MEMORY Out of memory + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1238,6 +1238,7 @@ int ua_service_create( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1259,6 +1260,7 @@ int ua_service_destroy( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1280,6 +1282,7 @@ int ua_service_add( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1302,6 +1305,7 @@ int ua_service_update( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1326,6 +1330,7 @@ int ua_service_remove( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1351,6 +1356,7 @@ int ua_service_get_default_service( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1401,6 +1407,7 @@ int ua_service_get_information(ua_service_h service_handle, * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1414,6 +1421,31 @@ int ua_get_service_by_name( /** * @ingroup CAPI_NETWORK_UA_MODULE + * @brief Gets user handle by account. + * @since_tizen 6.5 + * + * @remarks The @a user_handle should not be released. + * @remarks The @a user_handle can be used only in the function. + * + * @param[in] service_handle The service handle + * @param[in] account The user account information + * @param[out] user_handle The user handle + * + * @return 0 on success, otherwise a negative error value + * @retval #UA_ERROR_NONE Successful + * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet + * + * @exception + * @pre + * @post + * + */ +int ua_service_get_user_by_account(ua_service_h service_handle, + const char* account, ua_user_h *user_handle); + +/** + * @ingroup CAPI_NETWORK_UA_MODULE * @brief Sets detection threshold for service handle. * @since_tizen 6.5 * @@ -1424,6 +1456,7 @@ int ua_get_service_by_name( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1447,6 +1480,7 @@ int ua_service_set_detection_threshold( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1470,6 +1504,7 @@ int ua_service_get_detection_threshold( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1494,6 +1529,7 @@ int ua_service_set_name( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1516,6 +1552,7 @@ int ua_service_get_name( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1539,6 +1576,7 @@ int ua_service_add_user( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1562,6 +1600,7 @@ int ua_service_remove_user( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1587,6 +1626,7 @@ int ua_service_set_device_discriminant( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1611,6 +1651,7 @@ int ua_service_get_device_discriminant( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1634,6 +1675,7 @@ int ua_foreach_services( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1663,6 +1705,7 @@ int ua_service_foreach_users( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OUT_OF_MEMORY Out of memory + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1690,6 +1733,7 @@ int ua_device_create(ua_mac_type_e mac_type, * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OUT_OF_MEMORY Out of memory + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1715,6 +1759,7 @@ int ua_device_clone( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1736,6 +1781,7 @@ int ua_device_destroy( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1758,6 +1804,7 @@ int ua_device_set_mac_type( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1780,6 +1827,7 @@ int ua_device_get_mac_type( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1802,6 +1850,7 @@ int ua_device_set_os_info( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1824,6 +1873,7 @@ int ua_device_get_os_info( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1848,6 +1898,7 @@ int ua_device_set_mac_address( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1870,6 +1921,7 @@ int ua_device_get_mac_address( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1893,6 +1945,7 @@ int ua_device_set_device_id( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @see ua_device_set_device_id() */ @@ -1907,6 +1960,7 @@ int ua_device_get_device_id( * * @param[in] device_handle The device handle * @param[in] bssid The device's Wi-Fi BSSID. + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful @@ -1934,6 +1988,7 @@ int ua_device_set_wifi_bssid( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1955,6 +2010,7 @@ int ua_device_get_wifi_bssid( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -1979,6 +2035,7 @@ int ua_device_set_wifi_ipv4_address( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -2001,6 +2058,7 @@ int ua_device_get_wifi_ipv4_address( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -2022,6 +2080,7 @@ int ua_device_get_last_presence( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -2067,6 +2126,7 @@ int ua_device_get_information(ua_device_h device_handle, * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OPERATION_FAILED Operation failed + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -2093,6 +2153,7 @@ int ua_device_update( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OUT_OF_MEMORY Out of memory + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -2119,6 +2180,7 @@ int ua_device_get_by_mac_address( * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter * @retval #UA_ERROR_OUT_OF_MEMORY Out of memory + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -2141,6 +2203,7 @@ int ua_device_get_by_device_id( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -2162,6 +2225,7 @@ int ua_sensor_get_status( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre @@ -2183,6 +2247,7 @@ int ua_sensor_get_timestamp( * @return 0 on success, otherwise a negative error value * @retval #UA_ERROR_NONE Successful * @retval #UA_ERROR_INVALID_PARAMETER Invalid parameter + * @retval #UA_ERROR_NOT_INITIALIZED Not initialized yet * * @exception * @pre diff --git a/src/user-awareness-event-handler.c b/src/user-awareness-event-handler.c index 2708c3e..38da6e7 100755 --- a/src/user-awareness-event-handler.c +++ b/src/user-awareness-event-handler.c @@ -371,7 +371,7 @@ int ua_deinitialize(void) FUNC_ENTRY; int ret; - retv_if(TRUE != is_initialized, UA_ERROR_NOT_INITIALIZED); + UA_CHECK_INIT_STATUS(); __ua_cleanup(); |