summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAbhay Agarwal <ay.agarwal@samsung.com>2021-01-28 16:10:50 +0530
committerAbhay Agarwal <ay.agarwal@samsung.com>2021-01-28 17:00:06 +0530
commitb4b2bdf09ae75e82c97fd8db5ce87c602fa8220f (patch)
tree153aaf875dd24b8bd35d96c971c080f7783a311a
parent26cb7eb9e732747ad85af8cbf74765edc30e8c54 (diff)
downloaduser-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-xinclude/user-awareness-internal.h26
-rwxr-xr-xinclude/user-awareness.h159
-rwxr-xr-xsrc/user-awareness-event-handler.c2
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();