From bcce52379e10615bd1b2a8c4f7d34307a25f6c46 Mon Sep 17 00:00:00 2001 From: Jiung Yu Date: Thu, 20 Apr 2017 18:02:20 +0900 Subject: [PATCH] ACR-896 continued Change-Id: Id5ecc7868ae727fbf384c411d1574531b5f140b5 Signed-off-by: Yu jiung --- include/asp.h | 142 ++++---------------------------------------------- 1 file changed, 11 insertions(+), 131 deletions(-) diff --git a/include/asp.h b/include/asp.h index ad518cc..adfa94e 100755 --- a/include/asp.h +++ b/include/asp.h @@ -86,9 +86,8 @@ typedef enum { /** * @brief Enumeration for service discovery mechanism. * @since_tizen 4.0 - * @see asp_advert_set_tech() - * @see asp_advert_get_tech() - * @see asp_seek_set_tech() + * @see asp_advert_set_discovery_tech() + * @see asp_seek_set_discovery_tech() */ typedef enum { ASP_DISCOVERY_TECH_P2P = 1 << 0, /**< Use Wi-Fi P2P for discovery mechanism */ @@ -172,7 +171,7 @@ typedef enum { * @since_tizen 4.0 */ typedef enum { - ASP_SERVICE_STATUS_NOT_ADVERTISED , /**< Service status not advertised */ + ASP_SERVICE_STATUS_NOT_ADVERTISED, /**< Service status not advertised */ ASP_SERVICE_STATUS_ADVERTISED, /**< Service status advertised */ } asp_service_status_e; @@ -392,8 +391,6 @@ typedef void (*asp_session_port_status_cb) (int error_code, /** * @brief Initializes Application Service Platform (ASP). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @return 0 on success, otherwise a negative error value. * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_RESOURCE_BUSY Device or resource busy @@ -407,7 +404,6 @@ int asp_initialize(void); /** * @brief Deinitializes Application Service Platform (ASP). * @since_tizen 4.0 - * @privlevel public * @privilege http://tizen.org/privilege/wifidirect * @return 0 on success, otherwise a negative error value. * @retval #ASP_ERROR_NONE Successful @@ -423,7 +419,6 @@ int asp_deinitialize(void); /** * @brief Registers the callback function that will be invoked when a service found. * @since_tizen 4.0 - * @privlevel public * @param[in] cb The callback function to invoke * @param[in] user_data The user data passed from the callback registration function * @return 0 on success, otherwise a negative error value @@ -443,7 +438,6 @@ int asp_seek_set_search_result_cb(asp_seek_search_result_cb cb, void *user_data) /** * @brief Unregisters the callback function that will invoked when a service found. * @since_tizen 4.0 - * @privlevel public * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_SUPPORTED Not supported @@ -457,7 +451,6 @@ int asp_seek_unset_search_result_cb(void); /** * @brief Registers the callback function that will invoked when the status of an advertisement to a service is changed. * @since_tizen 4.0 - * @privlevel public * @param[in] cb The callback function to invoke * @param[in] user_data The user data passed from the callback registration function * @return 0 on success, otherwise a negative error value @@ -478,7 +471,6 @@ int asp_advert_set_status_changed_cb(asp_advert_status_changed_cb cb, /** * @brief Unregisters the callback function that will invoked when the status of an advertisement to a service is changed. * @since_tizen 4.0 - * @privlevel public * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_SUPPORTED Not supported @@ -492,7 +484,6 @@ int asp_advert_unset_status_changed_cb(void); /** * @brief Registers the callback called when ASP session connection is requested. * @since_tizen 4.0 - * @privlevel public * @param[in] cb The callback function to invoke * @param[in] user_data The user data passed from the callback registration function * @return 0 on success, otherwise a negative error value @@ -509,7 +500,6 @@ int asp_session_set_request_cb(asp_session_request_cb cb, void *user_data); /** * @brief Unregisters the callback called ASP when session connection is requested. * @since_tizen 4.0 - * @privlevel public * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_SUPPORTED Not supported @@ -523,7 +513,6 @@ int asp_session_unset_request_cb(void); /** * @brief Registers the callback called when the session configuration is requested. * @since_tizen 4.0 - * @privlevel public * @param[in] cb The callback function to invoke * @param[in] user_data The user data passed from the callback registration function * @return 0 on success, otherwise a negative error value @@ -542,7 +531,6 @@ int asp_session_set_config_request_cb(asp_session_config_request_cb cb, /** * @brief Unregisters the callback called when the session configuration is requested. * @since_tizen 4.0 - * @privlevel public * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_SUPPORTED Not supported @@ -556,7 +544,6 @@ int asp_session_unset_config_request_cb(void); /** * @brief Registers the callback called when the state of the session connection is changed. * @since_tizen 4.0 - * @privlevel public * @param[in] cb The callback function to invoke * @param[in] user_data The user data passed from the callback registration function * @return 0 on success, otherwise a negative error value @@ -574,7 +561,6 @@ int asp_session_set_connect_status_cb(asp_session_connect_status_cb cb, void *us /** * @brief Unregisters the callback called when the state of the session connection is changed. * @since_tizen 4.0 - * @privlevel public * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_SUPPORTED Not supported @@ -588,7 +574,6 @@ int asp_session_unset_connect_status_cb(void); /** * @brief Registers the callback called when the state of the session is changed. * @since_tizen 4.0 - * @privlevel public * @param[in] cb The callback function to invoke * @param[in] user_data The user data passed from the callback registration function * @return 0 on success, otherwise a negative error value @@ -606,7 +591,6 @@ int asp_session_set_status_cb(asp_session_status_cb cb, void *user_data); /** * @brief Unregisters the callback called when the state of the session is changed. * @since_tizen 4.0 - * @privlevel public * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_SUPPORTED Not supported @@ -620,7 +604,6 @@ int asp_session_unset_status_cb(void); /** * @brief Registers the callback called when the state of the port is changed. * @since_tizen 4.0 - * @privlevel public * @param[in] cb The callback function to invoke * @param[in] user_data The user data passed from the callback registration function * @return 0 on success, otherwise a negative error value @@ -636,7 +619,6 @@ int asp_session_set_port_status_cb(asp_session_port_status_cb cb, void *user_dat /** * @brief Unregisters the callback called when the state of the port is changed. * @since_tizen 4.0 - * @privlevel public * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_SUPPORTED Not supported @@ -650,8 +632,7 @@ int asp_session_unset_port_status_cb(void); /** * @brief Creates the description of a service to be advertised. * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect + * @remarks The @a adv_service should be released using asp_advert_destroy(). * @param[in] instance_name Service instance name of a service type to be advertised. * The length of this parameter be 63 byte or less and * encoding shall be single-byte or multi-byte UTF-8 characters. @@ -662,7 +643,6 @@ int asp_session_unset_port_status_cb(void); * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -677,14 +657,11 @@ int asp_advert_create(char *instance_name, asp_advert_service_h *adv_service); * @details If asp_advert_start_advertising() was called for a service, * asp_advert_stop_advertising() should be called for it before destroying it. * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] adv_service Service descriptor handle provided by the asp_advert_create() * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -701,8 +678,6 @@ int asp_advert_destroy(asp_advert_service_h adv_service); * asp_advert_create() and before advertising service using * asp_advert_start_advertising(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] adv_service Service descriptor handle provided by the asp_advert_create() * @param[in] service_type The unique type of a particular service. * this shall be at least 1 character and no more than 15 characters long @@ -715,7 +690,6 @@ int asp_advert_destroy(asp_advert_service_h adv_service); * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -733,15 +707,12 @@ int asp_advert_set_service_type(asp_advert_service_h adv_service, * asp_advert_create() and before advertising service using * asp_advert_start_advertising(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] adv_service Service descriptor handle provided by the asp_advert_create() * @param[in] auto_accept Enables/Disables auto accept based on the value TRUE/FALSE * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -759,8 +730,6 @@ int asp_advert_set_auto_accept(asp_advert_service_h adv_service, * asp_advert_create() and before advertising service using * asp_advert_start_advertising(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] adv_service Service descriptor handle provided by the asp_advert_create() * @param[in] key Service-defined key data specified in Section 6 of RFC6763 * @param[in] value Service-defined value data specified in Section 6 of RFC6763 @@ -771,7 +740,6 @@ int asp_advert_set_auto_accept(asp_advert_service_h adv_service, * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -789,11 +757,9 @@ int asp_advert_add_info(asp_advert_service_h adv_service, * @details Application should set service information after creating service using * asp_advert_create() and before advertising service using * asp_advert_start_advertising(). + * @since_tizen 4.0 * @remarks @a value should not be freed. * It is recommended to make a copy of it to use. - * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] adv_service Service descriptor handle provided by the asp_advert_create() * @param[in] key Service-defined key data specified in Section 6 of RFC6763 * @param[in] length Length of service-defined value data specified in Section 6 of RFC6763 @@ -802,7 +768,6 @@ int asp_advert_add_info(asp_advert_service_h adv_service, * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -821,15 +786,12 @@ int asp_advert_get_info(asp_advert_service_h adv_service, const char *key, * asp_advert_create() and before advertising service using * asp_advert_start_advertising(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] adv_service Service descriptor handle provided by the asp_advert_create() * @param[in] key Service-defined key data specified to be removed * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -846,8 +808,6 @@ int asp_advert_remove_info(asp_advert_service_h adv_service, const char *key); * asp_advert_create() and before advertising service using * asp_advert_start_advertising(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] adv_service Service descriptor handle provided by the asp_advert_create() * @param[in] status Status of the service: * (@c 1 = available to use, @c 0 = not available to use, @@ -856,7 +816,6 @@ int asp_advert_remove_info(asp_advert_service_h adv_service, const char *key); * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -875,8 +834,6 @@ int asp_advert_set_status(asp_advert_service_h adv_service, * asp_advert_create() and before advertising service using * asp_advert_start_advertising(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] adv_service Service descriptor handle provided by the asp_advert_create() * @param[in] discovery_tech The discovery mechanism; values of * #asp_discovery_tech_e combined with bitwise 'or' @@ -884,7 +841,6 @@ int asp_advert_set_status(asp_advert_service_h adv_service, * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -901,15 +857,12 @@ int asp_advert_set_discovery_tech(asp_advert_service_h adv_service, int discover * asp_advert_create() and before advertising service using * asp_advert_start_advertising(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] adv_service Service descriptor handle provided by the asp_advert_create() * @param[in] preferred_connection The preferred connection * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -927,8 +880,6 @@ int asp_advert_set_preferred_connection(asp_advert_service_h adv_service, * asp_advert_create() and before advertising service using * asp_advert_start_advertising(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] adv_service Service descriptor handle provided by the asp_advert_create() * @param[in] role The role of the service: \n * #ASP_ADVERT_P2P_ROLE_SCHEME_ANY - All roles are acceptable \n @@ -941,7 +892,6 @@ int asp_advert_set_preferred_connection(asp_advert_service_h adv_service, * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -960,8 +910,6 @@ int asp_advert_set_p2p_role_scheme(asp_advert_service_h adv_service, * asp_advert_create() and before advertising service using * asp_advert_start_advertising(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] adv_service Service descriptor handle provided by the asp_advert_create() * @param[in] role The role of the service: \n * #ASP_ADVERT_P2P_ROLE_SCHEME_ANY - All roles are acceptable \n @@ -973,7 +921,6 @@ int asp_advert_set_p2p_role_scheme(asp_advert_service_h adv_service, * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -991,8 +938,6 @@ int asp_advert_get_p2p_role_scheme(asp_advert_service_h adv_service, * asp_advert_create() and before advertising service using * asp_advert_start_advertising(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] adv_service Service descriptor handle provided by the asp_advert_create() * @param[in] config_method preferred Wi-Fi Simple Config (WSC) configuration method. * Default value is ASP_WPS_TYPE_DEFAULT. @@ -1000,7 +945,6 @@ int asp_advert_get_p2p_role_scheme(asp_advert_service_h adv_service, * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1017,15 +961,12 @@ int asp_advert_set_p2p_config_method(asp_advert_service_h adv_service, * asp_advert_create() and before advertising service using * asp_advert_start_advertising(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] adv_service Service descriptor handle provided by the asp_advert_create() * @param[in] config_method preferred Wi-Fi Simple Config (WSC)configuration method. * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1043,8 +984,6 @@ int asp_advert_get_p2p_config_method(asp_advert_service_h adv_service, * asp_advert_create() and before advertising service using * asp_advert_create(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] adv_service Service descriptor handle provided by the asp_advert_create() * @param[in] rsp_info Specified for a particular service up to 144 bytes. * You can refer to Wi-Fi Peer-to-Peer Services Technical Specification, @@ -1054,7 +993,6 @@ int asp_advert_get_p2p_config_method(asp_advert_service_h adv_service, * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1142,9 +1080,8 @@ int asp_advert_change_service_status(asp_advert_service_h adv_service, /** * @brief Creates the description of a seek operation. + * @remarks The @a seek_service should be released using asp_seek_destroy(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] service_type Service Type of a service being searched. * this shall be at least 1 character and no more than 15 characters long * contain only US-ASCII [ANSI.X3.4-1986] letters 'A' - 'Z' and @@ -1157,7 +1094,6 @@ int asp_advert_change_service_status(asp_advert_service_h adv_service, * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1173,14 +1109,11 @@ int asp_seek_create(char *service_type, asp_seek_service_h *seek_service); * asp_seek_stop() should be called for it before destroying it. * asp_seek_stop(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] seek_service Service seek handle provided by the asp_seek_create() * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1197,7 +1130,6 @@ int asp_seek_destroy(asp_seek_service_h seek_service); * asp_seek_create() and before seeking service using asp_seek_start(). * @since_tizen 4.0 * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] seek_service Service descriptor handle provided by the asp_seek_create() * @param[in] key Service-defined key data to be searched, * specified in Section 6 of RFC6763 @@ -1205,7 +1137,6 @@ int asp_seek_destroy(asp_seek_service_h seek_service); * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1221,8 +1152,6 @@ int asp_seek_add_info(asp_seek_service_h seek_service, const char *key); * @details Application should set service information after creating service using * asp_seek_create() and before seeking service using asp_seek_start(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] seek_service Service descriptor handle provided by the asp_seek_create() * @param[in] key Service-defined key data to be searched, * specified in Section 6 of RFC6763 @@ -1230,7 +1159,6 @@ int asp_seek_add_info(asp_seek_service_h seek_service, const char *key); * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1246,16 +1174,13 @@ int asp_seek_remove_info(asp_seek_service_h seek_service, const char *key); * @details Application should set service information after creating service using * asp_seek_create() and before seeking service using asp_seek_start(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] adv_service Service descriptor handle provided by the asp_seek_create() * @param[in] discovery_tech The discovery mechanism, values of - * #asp_discovery_tech_e combined with bitiwse 'or' + * #asp_discovery_tech_e combined with bitwise 'or' * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1271,15 +1196,12 @@ int asp_seek_set_discovery_tech(asp_seek_service_h seek_service, int discovery_t * @details Application should set service information after creating service using * asp_seek_create() and before seeking service using asp_seek_start(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect - * @param[in] adv_service Service descriptor handle provided by the asp_seek_create() + * @param[in] seek_service Service descriptor handle provided by the asp_seek_create() * @param[in] preferred_connection The preferred connection * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1340,8 +1262,7 @@ int asp_seek_stop(asp_seek_service_h seek_service); /** * @brief Creates a local Application Service Platform (ASP) session. * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect + * @remarks The @a session should be released using asp_session_destroy(). * @param[in] service_mac P2P device address of remote P2P device provided by * asp_seek_search_result_cb() * @param[in] adv_id The advertisement ID provided by @@ -1351,7 +1272,6 @@ int asp_seek_stop(asp_seek_service_h seek_service); * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1365,14 +1285,11 @@ int asp_session_create(char *service_mac, unsigned int adv_id, * @brief Destroys a local Application Service Platform (ASP) session. * @details Application should create session by asp_session_create(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] session Application Service Platform session descriptor handle * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1387,11 +1304,9 @@ int asp_session_destroy(asp_session_h session); * @brief Gets the session MAC for an Application Service Platform session. * @details Application should request to connect session by * asp_session_connect() or receive request by asp_session_request_cb(). + * @since_tizen 4.0 * @remarks @a session_mac should not be freed. * It is recommended to make a copy of it to use. - * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] session Application Service Platform session descriptor handle * @param[out] session_mac The session MAC is the MAC address of * P2P device which assigned the session ID @@ -1399,7 +1314,6 @@ int asp_session_destroy(asp_session_h session); * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1416,15 +1330,12 @@ int asp_session_get_mac(asp_session_h session, char **session_mac); * @details Application should create local session by * asp_session_create() or receive request by asp_session_request_cb(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] session Application Service Platform session descriptor handle * @param[out] session_id The session ID * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1442,8 +1353,6 @@ int asp_session_get_id(asp_session_h session, unsigned int *session_id); * asp_session_create() and before requesting to connect * session by asp_session_connect(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] session Application Service Platform session descriptor handle * provided by the asp_session_create() * @param[in] session_info Detailed information about the session. @@ -1455,7 +1364,6 @@ int asp_session_get_id(asp_session_h session, unsigned int *session_id); * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1471,11 +1379,9 @@ int asp_session_set_info(asp_session_h session, char *session_info); * @details Application should get session_info after creating session by * asp_session_create() and before requesting to connect * session by asp_session_connect(). + * @since_tizen 4.0 * @remarks @a session_info should not be freed. * It is recommended to make a copy of it to use. - * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] session Application Service Platform session descriptor handle * provided by the asp_session_create() * @param[out] session_info detailed information about session @@ -1483,7 +1389,6 @@ int asp_session_set_info(asp_session_h session, char *session_info); * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1500,8 +1405,6 @@ int asp_session_get_info(asp_session_h session, char **session_info); * asp_session_create() and before requesting to connect * session by asp_session_connect(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] session Application Service Platform session descriptor handle * provided by the asp_session_create() * @param[in] role The role of the service: \n @@ -1515,7 +1418,6 @@ int asp_session_get_info(asp_session_h session, char **session_info); * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1531,8 +1433,6 @@ int asp_session_set_p2p_role_scheme(asp_session_h session, /** * @brief Gets the Wi-Fi Direct group role in session. * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] session Application Service Platform session descriptor handle * provided by the asp_session_create() * @param[in] role The role of the service: \n @@ -1545,7 +1445,6 @@ int asp_session_set_p2p_role_scheme(asp_session_h session, * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1563,8 +1462,6 @@ int asp_session_get_p2p_role_scheme(asp_session_h session, * asp_session_create() and before requesting to connect * session by asp_session_connect(). * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] session Application Service Platform session descriptor handle * provided by the asp_session_create() * @param[in] config_method Preferred WSC Configuration method. @@ -1573,7 +1470,6 @@ int asp_session_get_p2p_role_scheme(asp_session_h session, * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1588,8 +1484,6 @@ int asp_session_set_p2p_config_method(asp_session_h session, /** * @brief Gets the Preferred WSC Configuration method. * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] session Application Service Platform session descriptor handle * provided by the asp_session_create() * @param[out] config_method Preferred WSC Configuration method @@ -1597,7 +1491,6 @@ int asp_session_set_p2p_config_method(asp_session_h session, * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1622,7 +1515,6 @@ int asp_session_get_p2p_config_method(asp_session_h session, * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1679,8 +1571,6 @@ int asp_session_confirm(asp_session_h session, bool confirmed, char *pin); /** * @brief Gets the Description of Application Service Platform (ASP) session to be connected. * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] session_mac The MAC address of the P2P device that assigned * the value of session_id, as provided by * the asp_session_request_cb() callback or @@ -1691,7 +1581,6 @@ int asp_session_confirm(asp_session_h session, bool confirmed, char *pin); * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1705,15 +1594,12 @@ int asp_session_get_handle(char *session_mac, unsigned int session_id, /** * @brief Moves an Application Service Platform (ASP) session from Requested state to the Open state. * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] session ASP session descriptor handle provided by * the asp_session_request_cb() callback * @return 0 on success, otherwise a negative error value * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1754,8 +1640,6 @@ int asp_session_close(asp_session_h session); /** * @brief Requests that incoming connections be allowed on a given port. * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] session ASP session descriptor handle provided by * the asp_session_request_cb() callback or * asp_session_create() @@ -1766,7 +1650,6 @@ int asp_session_close(asp_session_h session); * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized @@ -1781,8 +1664,6 @@ int asp_session_bind_port(asp_session_h session, char *ip_address, /** * @brief Indicates that the service is no longer utilizing the port in the ASP session. * @since_tizen 4.0 - * @privlevel public - * @privilege http://tizen.org/privilege/wifidirect * @param[in] session ASP session descriptor handle provided by * the asp_session_request_cb() callback or * asp_session_create() @@ -1793,7 +1674,6 @@ int asp_session_bind_port(asp_session_h session, char *ip_address, * @retval #ASP_ERROR_NONE Successful * @retval #ASP_ERROR_NOT_PERMITTED Operation not permitted * @retval #ASP_ERROR_OUT_OF_MEMORY Out of memory - * @retval #ASP_ERROR_PERMISSION_DENIED Permission denied * @retval #ASP_ERROR_INVALID_PARAMETER Invalid parameter * @retval #ASP_ERROR_NOT_SUPPORTED Not supported * @retval #ASP_ERROR_NOT_INITIALIZED Not initialized -- 2.34.1