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>

diff --git a/include/user-awareness-internal.h b/include/user-awareness-internal.h
index c3d9a48cbdd47d4a3b8226e6a07bd3daceebb907..681cb9864f20bd7e8dbd6174c19509ceb1beadea 100755 (executable)
--- 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 fee1e7bdb42910126d651156a141607dfab77dd8..fe19015e74dae030c1a21486d0dee3b67e28ec20 100755 (executable)
--- a/include/user-awareness.h
+++ b/include/user-awareness.h
@@ -480,6 +480,29 @@ typedef bool (*ua_service_added_user_cb)(
                ua_user_h user_handle,
                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
@@ -1078,53 +1121,6 @@ int ua_user_get_information(ua_user_h user_handle,
 int ua_user_get_handle_by_account(const char* account,
                ua_user_h *user_handle) TIZEN_DEPRECATED_API;
 
-/**
- * @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.
@@ -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
@@ -1412,6 +1419,31 @@ int ua_get_service_by_name(
                        const char *name,
                        ua_service_h *service_handle);
 
+/**
+ * @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.
@@ -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 2708c3e6f2883be63fb219ef7bfe51b0b9592a05..38da6e792f98fbb36be9e09dcb8459deba7a27a9 100755 (executable)
--- 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();