*/
/**
- * @brief The wifi manager handle.
+ * @brief The Wi-Fi manager handle.
* @since_tizen 3.0
*/
typedef void *wifi_manager_h;
*/
/**
- * @brief Called when the WiFi TDLS state is changed.
+ * @brief Called when the Wi-Fi TDLS state is changed.
* @since_tizen 3.0
*
* @param[in] state The TDLS state
* @privlevel public
* @privilege %http://tizen.org/privilege/network.get
* @remarks You must release @a handle using wifi_manager_deinitialize().
- * @param[out] wifi The wifi handle
+ * @param[out] wifi The Wi-Fi handle
* @return @c 0 on success, otherwise negative error value
* @retval #WIFI_MANAGER_ERROR_NONE Successful
* @retval #WIFI_MANAGER_ERROR_ALREADY_INITIALIZED Already initialized
/**
* @brief Deinitializes Wi-Fi.
* @since_tizen 3.0
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @return 0 on success, otherwise negative error value
* @retval #WIFI_MANAGER_ERROR_NONE Successful
* @retval #WIFI_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
* @privilege %http://tizen.org/privilege/network.set \n
* %http://tizen.org/privilege/network.get
* @remark This API needs both privileges.
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] callback The callback function to be called \n
* This can be @c NULL if you don't want to get the notification.
* @param[in] user_data The user data passed to the callback function
* @privilege %http://tizen.org/privilege/network.set \n
* %http://tizen.org/privilege/network.get
* @remark This API needs both privileges.
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] callback The callback function to be called \n
* This can be @c NULL if you don't want to get the notification.
* @param[in] user_data The user data passed to the callback function
* @privilege %http://tizen.org/privilege/network.set \n
* %http://tizen.org/privilege/network.get
* @remark This API needs both privileges.
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] callback The callback function to be called \n
* This can be @c NULL if you don't want to get the notification.
* @param[in] user_data The user data passed to the callback function
* @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/network.get
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[out] activated @c true if Wi-Fi is activated,
* otherwise @c false if Wi-Fi is not activated.
* @return 0 on success, otherwise negative error value
* @brief Gets the local MAC address.
* @since_tizen 3.0
* @remarks You must release @a mac_address using free().
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[out] mac_address The MAC address
* @return 0 on success, otherwise negative error value
* @retval #WIFI_MANAGER_ERROR_NONE Successful
* @privlevel public
* @privilege %http://tizen.org/privilege/network.get
* @remarks You must release @a name using free().
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[out] name The name of network interface
* @return 0 on success, otherwise negative error value
* @retval #WIFI_MANAGER_ERROR_NONE Successful
* @privilege %http://tizen.org/privilege/network.set \n
* %http://tizen.org/privilege/network.get
* @remark This API needs both privileges.
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] callback The callback function to be called
* @param[in] user_data The user data passed to the callback function
* @return 0 on success, otherwise negative error value
int wifi_manager_scan(wifi_manager_h wifi, wifi_manager_scan_finished_cb callback, void *user_data);
/**
+ * @brief Gets the Wi-Fi scan state.
+ * @since_tizen 4.0
+ * @param[in] wifi The Wi-Fi handle
+ * @param[in] scan_state The Wi-Fi scan state
+ * @return 0 on success, otherwise negative error value
+ * @retval #WIFI_MANAGER_ERROR_NONE Successful
+ * @retval #WIFI_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval #WIFI_MANAGER_ERROR_INVALID_OPERATION Invalid operation
+ * @retval #WIFI_MANAGER_ERROR_NOT_SUPPORTED Not supported
+ */
+int wifi_manager_get_scan_state(wifi_manager_h wifi, wifi_manager_scan_state_e *scan_state);
+
+/**
* @brief Starts specific AP scan, asynchronously.
* @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/network.set \n
* %http://tizen.org/privilege/network.get
* @remark This API needs both privileges.
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] essid The essid of specific AP
* @param[in] callback The callback function to be called
* @param[in] user_data The user data passed to the callback function
* @privlevel public
* @privilege %http://tizen.org/privilege/network.get
* @remarks You must release @a handle using wifi_manager_ap_destroy().
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[out] ap The access point handle
* @return 0 on success, otherwise negative error value
* @retval #WIFI_MANAGER_ERROR_NONE Successful
* @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/network.get
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] callback The callback to be called
* @param[in] user_data The user data passed to the callback function
* @return 0 on success, otherwise negative error value
* @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/network.get
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] callback The callback to be called
* @param[in] user_data The user data passed to the callback function
* @return 0 on success, otherwise negative error value.
* @privilege %http://tizen.org/privilege/network.set \n
* %http://tizen.org/privilege/network.get
* @remark This API needs both privileges.
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] ap The access point handle
* @param[in] callback The callback function to be called \n
* This can be @c NULL if you don't want to get the notification.
* @privilege %http://tizen.org/privilege/network.set \n
* %http://tizen.org/privilege/network.get
* @remark This API needs both privileges.
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] ap The access point handle
* @param[in] callback The callback function to be called \n
* This can be @c NULL if you don't want to get the notification.
* @privilege %http://tizen.org/privilege/network.profile \n
* %http://tizen.org/privilege/network.get
* @remark This API needs both privileges.
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] ap The access point handle
* @param[in] callback The callback function to be called \n
* This can be NULL if you don't want to get the notification.
* @privilege %http://tizen.org/privilege/network.profile \n
* %http://tizen.org/privilege/network.get
* @remark This API needs both privileges.
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] ap The access point handle
* @param[in] pin The WPS PIN is a non-NULL string with length greater than 0 and less than or equal to 8
* @param[in] callback The callback function to be called (this can be NULL if you don't want to get the notification)
* @privilege %http://tizen.org/privilege/network.profile \n
* %http://tizen.org/privilege/network.get
* @remark This API needs both privileges.
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] ap The access point handle
* @return 0 on success, otherwise negative error value
* @retval #WIFI_MANAGER_ERROR_NONE Successful
* @privilege %http://tizen.org/privilege/network.profile \n
* %http://tizen.org/privilege/network.get
* @remark This API needs both privileges.
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] ap The access point handle
* @return 0 on success, otherwise negative error value
* @retval #WIFI_MANAGER_ERROR_NONE Successful
* @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/network.get
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[out] connection_state The connection state
* @return 0 on success, otherwise negative error value
* @retval #WIFI_MANAGER_ERROR_NONE Successful
/**
* @brief Registers the callback called when the device state is changed.
* @since_tizen 3.0
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] callback The callback function to be called
* @param[in] user_data The user data passed to the callback function
* @return 0 on success, otherwise negative error value
/**
* @brief Unregisters the callback called when the device state is changed.
* @since_tizen 3.0
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @return 0 on success, otherwise negative error value
* @retval #WIFI_MANAGER_ERROR_NONE Successful
* @retval #WIFI_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
/**
* @brief Registers the callback called when the background scan is finished.
* @since_tizen 3.0
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] callback The callback function to be called
* @param[in] user_data The user data passed to the callback function
* @return 0 on success, otherwise negative error value
/**
* @brief Unregisters the callback called when the scan is finished.
* @since_tizen 3.0
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @return 0 on success, otherwise negative error value
* @retval #WIFI_MANAGER_ERROR_NONE Successful
* @retval #WIFI_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
/**
* @brief Registers the callback called when the connection state is changed.
* @since_tizen 3.0
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] callback The callback function to be called
* @param[in] user_data The user data passed to the callback function
* @return 0 on success, otherwise negative error value
/**
* @brief Unregisters the callback called when the connection state is changed.
* @since_tizen 3.0
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @return 0 on success, otherwise negative error value
* @retval #WIFI_MANAGER_ERROR_NONE Successful
* @retval #WIFI_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
/**
* @brief Registers callback called when the RSSI of connected Wi-Fi is changed.
* @since_tizen 3.0
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] callback The callback function to be called
* @param[in] user_data The user data passed to the callback function
* @return 0 on success, otherwise negative error value
/**
* @brief Unregisters callback called when the RSSI of connected Wi-Fi is changed.
* @since_tizen 3.0
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @return 0 on success, otherwise negative error value
* @retval #WIFI_MANAGER_ERROR_NONE Successful
* @retval #WIFI_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter
* @brief Creates the access point handle.
* @since_tizen 3.0
* @remarks You must release @a AP using wifi_manager_ap_destroy().
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] essid The ESSID (Extended Service Set Identifier) should be null-terminated and can be UTF-8 encoded
* @param[out] ap The access point handle
* @return 0 on success, otherwise negative error value
* @brief Creates the hidden access point handle.
* @since_tizen 3.0
* @remarks You must release @a AP using wifi_manager_ap_destroy().
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] essid The ESSID (Extended Service Set Identifier) should be null-terminated and can be UTF-8 encoded
* @param[out] ap The access point handle
* @return 0 on success, otherwise negative error value
* @since_tizen 3.0
* @remarks You must release @a config using wifi_manager_config_destroy().
*
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] name The access point name
* @param[in] passphrase The access point passphrase
* @param[in] security_type The access point security type
* @privlevel public
* @privilege %http://tizen.org/privilege/network.profile
*
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] config The access point configuration handle
*
* @return 0 on success, otherwise negative error value
* @privlevel public
* @privilege %http://tizen.org/privilege/network.profile
*
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] config The access point configuration handle
*
* @return 0 on success, otherwise negative error value
* @privlevel public
* @privilege %http://tizen.org/privilege/network.profile
*
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] callback The callback to be called
* @param[in] user_data The user data passed to the callback function
*
* @privlevel public
* @privilege %http://tizen.org/privilege/network.set
*
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] peer_mac_addr The MAC address of the connected peer
*
* @return @c 0 on success, otherwise negative error value
* @privilege %http://tizen.org/privilege/network.get
*
* @remarks The @a peer_mac_addr should be freed using free().
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[out] peer_mac_addr The MAC address of the connected peer
*
* @return @c 0 on success, otherwise negative error value
* @brief Registers the callback called when TDLS state is changed.
* @since_tizen 3.0
*
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @param[in] callback The callback function to be called
* @param[in] user_data The user data passed to the callback function
*
* @brief Unregisters the callback called when TDLS state is changed.
* @since_tizen 3.0
*
- * @param[in] wifi The wifi handle
+ * @param[in] wifi The Wi-Fi handle
* @return @c 0 on success, otherwise negative error value
* @retval #WIFI_MANAGER_ERROR_NONE Successful
* @retval #WIFI_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter