/**
* @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 */
* @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;
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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
/**
* @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.
* @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
* @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
* 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
* @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
* 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
* 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
* @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
* @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
* @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
* 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
* 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,
* @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
* 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'
* @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
* 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
* 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
* @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
* 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
* @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
* 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.
* @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
* 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
* 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,
* @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
/**
* @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
* @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
* 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
* 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
* @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
* @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
* @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
* @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
* @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
/**
* @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
* @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
* @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
* @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
* @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
* @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
* 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.
* @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
* @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
* @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
* 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
* @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
/**
* @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
* @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
* 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.
* @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
/**
* @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
* @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
* @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
/**
* @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
* @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
/**
* @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
/**
* @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()
* @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
/**
* @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()
* @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