include/wifi.h

   1 /*
   2  * Copyright (c) 2012-2013 Samsung Electronics Co., Ltd All Rights Reserved
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  * http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 #ifndef __TIZEN_NETWORK_WIFI_H__
  18 #define __TIZEN_NETWORK_WIFI_H__
  19
  20 #include <tizen.h>
  21
  22 #ifdef __cplusplus
  23 extern "C" {
  24 #endif
  25
  26 /**
  27  * @file wifi.h
  28  */
  29
  30 /**
  31 * @addtogroup CAPI_NETWORK_WIFI_MANAGEMENT_MODULE
  32 * @{
  33 */
  34
  35 /**
  36  * @deprecated Deprecated since 3.0. Use wifi_manager_error_e instead.
  37  * @brief Enumeration for the Wi-Fi error type.
  38  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  39  */
  40 typedef enum
  41 {
  42     WIFI_ERROR_NONE = TIZEN_ERROR_NONE,                                                 /**< Successful */
  43     WIFI_ERROR_INVALID_PARAMETER = TIZEN_ERROR_INVALID_PARAMETER,                       /**< Invalid parameter */
  44     WIFI_ERROR_OUT_OF_MEMORY = TIZEN_ERROR_OUT_OF_MEMORY,                               /**< Out of memory error */
  45     WIFI_ERROR_INVALID_OPERATION = TIZEN_ERROR_INVALID_OPERATION,                       /**< Function not implemented or Invalid operation (e.g., already initialized)*/
  46     WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED = TIZEN_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED, /**< Address family not supported */
  47     WIFI_ERROR_OPERATION_FAILED = TIZEN_ERROR_WIFI|0x0301,                              /**< Operation failed */
  48     WIFI_ERROR_NO_CONNECTION = TIZEN_ERROR_WIFI|0x0302,                                 /**< There is no connected AP */
  49     WIFI_ERROR_NOW_IN_PROGRESS = TIZEN_ERROR_NOW_IN_PROGRESS,                           /**< Now in progress */
  50     WIFI_ERROR_ALREADY_EXISTS = TIZEN_ERROR_WIFI|0x0303,                                /**< Already exists */
  51     WIFI_ERROR_OPERATION_ABORTED = TIZEN_ERROR_WIFI|0x0304,                             /**< Operation is aborted */
  52     WIFI_ERROR_DHCP_FAILED = TIZEN_ERROR_WIFI|0x0306,                                   /**< DHCP failed */
  53     WIFI_ERROR_INVALID_KEY = TIZEN_ERROR_WIFI|0x0307,                                   /**< Invalid key */
  54     WIFI_ERROR_NO_REPLY = TIZEN_ERROR_WIFI|0x0308,                                      /**< No reply */
  55     WIFI_ERROR_SECURITY_RESTRICTED = TIZEN_ERROR_WIFI|0x0309,                           /**< Restricted by security system policy */
  56     WIFI_ERROR_PERMISSION_DENIED = TIZEN_ERROR_PERMISSION_DENIED,                       /**< Permission Denied */
  57     WIFI_ERROR_NOT_SUPPORTED = TIZEN_ERROR_NOT_SUPPORTED                /**< Not Supported */
  58 } wifi_error_e;
  59
  60 /**
  61 * @}
  62 */
  63
  64
  65 /**
  66 * @addtogroup CAPI_NETWORK_WIFI_MONITOR_MODULE
  67 * @{
  68 */
  69
  70 /**
  71  * @deprecated Deprecated since 3.0. Use wifi_manager_device_state_e instead.
  72  * @brief Enumeration for the state of the Wi-Fi device.
  73  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  74  */
  75 typedef enum
  76 {
  77     WIFI_DEVICE_STATE_DEACTIVATED = 0,  /**< Wi-Fi is Deactivated */
  78     WIFI_DEVICE_STATE_ACTIVATED = 1,    /**< Wi-Fi is activated */
  79 } wifi_device_state_e;
  80
  81 /**
  82  * @deprecated Deprecated since 3.0. Use wifi_manager_connection_state_e instead.
  83  * @brief Enumeration for the state of the Wi-Fi connection.
  84  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  85  */
  86 typedef enum
  87 {
  88         WIFI_CONNECTION_STATE_FAILURE = -1,             /**< Connection failed state */
  89         WIFI_CONNECTION_STATE_DISCONNECTED = 0,         /**< Disconnected state */
  90         WIFI_CONNECTION_STATE_ASSOCIATION = 1,          /**< Association state */
  91         WIFI_CONNECTION_STATE_CONFIGURATION = 2,        /**< Configuration state */
  92         WIFI_CONNECTION_STATE_CONNECTED = 3,            /**< Connected state */
  93 } wifi_connection_state_e;
  94
  95 /**
  96  * @deprecated Deprecated since 3.0. Use wifi_manager_rssi_level_e instead.
  97  * @brief Enumeration for the RSSI level.
  98  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  99  */
 100 typedef enum
 101 {
 102     WIFI_RSSI_LEVEL_0 = 0,  /**< level 0 */
 103     WIFI_RSSI_LEVEL_1 = 1,  /**< level 1 */
 104     WIFI_RSSI_LEVEL_2 = 2,  /**< level 2 */
 105     WIFI_RSSI_LEVEL_3 = 3,  /**< level 3 */
 106     WIFI_RSSI_LEVEL_4 = 4,  /**< level 4 */
 107 } wifi_rssi_level_e;
 108
 109 /**
 110 * @}
 111 */
 112
 113
 114 /**
 115 * @addtogroup CAPI_NETWORK_WIFI_AP_NETWORK_MODULE
 116 * @{
 117 */
 118
 119 /**
 120  * @deprecated Deprecated since 3.0. Use wifi_manager_ip_config_type_e instead.
 121  * @brief Enumeration for the Net IP configuration type.
 122  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 123  */
 124 typedef enum
 125 {
 126     WIFI_IP_CONFIG_TYPE_NONE = 0,       /**< Not defined */
 127     WIFI_IP_CONFIG_TYPE_STATIC  = 1,    /**< Manual IP configuration */
 128     WIFI_IP_CONFIG_TYPE_DYNAMIC = 2,    /**< Config IP using DHCP client*/
 129     WIFI_IP_CONFIG_TYPE_AUTO = 3,       /**< Config IP from Auto IP pool (169.254/16). Later with DHCP client, if available */
 130     WIFI_IP_CONFIG_TYPE_FIXED = 4,      /**< Indicates an IP address that can not be modified */
 131 } wifi_ip_config_type_e;
 132
 133 /**
 134  * @deprecated Deprecated since 3.0. Use wifi_manager_address_family_e instead.
 135  * @brief Enumeration for the address type.
 136  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 137  */
 138 typedef enum
 139 {
 140     WIFI_ADDRESS_FAMILY_IPV4 = 0,  /**< IPV4 Address family */
 141     WIFI_ADDRESS_FAMILY_IPV6 = 1,  /**< IPV6 Address family */
 142 } wifi_address_family_e;
 143
 144 /**
 145  * @deprecated Deprecated since 3.0. Use wifi_manager_proxy_type_e instead.
 146  * @brief Enumeration for the proxy method type.
 147  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 148  */
 149 typedef enum
 150 {
 151     WIFI_PROXY_TYPE_DIRECT = 0, /**< Direct connection */
 152     WIFI_PROXY_TYPE_AUTO = 1,   /**< Auto configuration(Use PAC file). If URL property is not set, DHCP/WPAD auto-discover will be tried */
 153     WIFI_PROXY_TYPE_MANUAL  = 2 /**< Manual configuration */
 154 } wifi_proxy_type_e;
 155
 156 /**
 157 * @}
 158 */
 159
 160
 161 /**
 162 * @addtogroup CAPI_NETWORK_WIFI_AP_SECURITY_MODULE
 163 * @{
 164 */
 165
 166 /**
 167  * @deprecated Deprecated since 3.0. Use wifi_manager_security_type_e instead.
 168  * @brief Enumeration for Wi-Fi security type.
 169  * @details The following security modes are used in infrastructure and ad-hoc mode.
 170  * For now all EAP security mechanisms are provided only in infrastructure mode.
 171  *
 172  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 173  */
 174 typedef enum
 175 {
 176     WIFI_SECURITY_TYPE_NONE = 0,        /**< Security disabled */
 177     WIFI_SECURITY_TYPE_WEP = 1,         /**< WEP */
 178     WIFI_SECURITY_TYPE_WPA_PSK = 2,     /**< WPA-PSK */
 179     WIFI_SECURITY_TYPE_WPA2_PSK = 3,    /**< WPA2-PSK */
 180     WIFI_SECURITY_TYPE_EAP = 4,         /**< EAP */
 181 } wifi_security_type_e;
 182
 183 /**
 184  * @deprecated Deprecated since 3.0. Use wifi_manager_encryption_type_e instead.
 185  * @brief Enumeration for Wi-Fi encryption type.
 186  * @details The following encryption modes are used in infrastructure and ad-hoc mode.
 187  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 188  */
 189 typedef enum
 190 {
 191     WIFI_ENCRYPTION_TYPE_NONE = 0,              /**< Encryption disabled */
 192     WIFI_ENCRYPTION_TYPE_WEP = 1,               /**< WEP */
 193     WIFI_ENCRYPTION_TYPE_TKIP = 2,              /**< TKIP */
 194     WIFI_ENCRYPTION_TYPE_AES = 3,               /**< AES */
 195     WIFI_ENCRYPTION_TYPE_TKIP_AES_MIXED = 4,    /**< TKIP and AES are both supported */
 196 } wifi_encryption_type_e;
 197
 198 /**
 199 * @}
 200 */
 201
 202
 203 /**
 204 * @addtogroup CAPI_NETWORK_WIFI_AP_SECURITY_EAP_MODULE
 205 * @{
 206 */
 207
 208 /**
 209  * @deprecated Deprecated since 3.0. Use wifi_manager_eap_type_e instead.
 210  * @brief Enumeration for EAP type.
 211  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 212  */
 213 typedef enum
 214 {
 215     WIFI_EAP_TYPE_PEAP = 0,     /**< EAP PEAP type */
 216     WIFI_EAP_TYPE_TLS = 1,      /**< EAP TLS type */
 217     WIFI_EAP_TYPE_TTLS = 2,     /**< EAP TTLS type */
 218     WIFI_EAP_TYPE_SIM = 3,      /**< EAP SIM type */
 219     WIFI_EAP_TYPE_AKA = 4,      /**< EAP AKA type */
 220 } wifi_eap_type_e;
 221
 222 /**
 223  * @deprecated Deprecated since 3.0. Use wifi_manager_eap_auth_type_e instead.
 224  * @brief Enumeration for EAP phase2 authentication type.
 225  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 226  */
 227 typedef enum
 228 {
 229     WIFI_EAP_AUTH_TYPE_NONE = 0,        /**< EAP phase2 authentication none */
 230     WIFI_EAP_AUTH_TYPE_PAP = 1,         /**< EAP phase2 authentication PAP */
 231     WIFI_EAP_AUTH_TYPE_MSCHAP = 2,      /**< EAP phase2 authentication MSCHAP */
 232     WIFI_EAP_AUTH_TYPE_MSCHAPV2 = 3,    /**< EAP phase2 authentication MSCHAPv2 */
 233     WIFI_EAP_AUTH_TYPE_GTC = 4,         /**< EAP phase2 authentication GTC */
 234     WIFI_EAP_AUTH_TYPE_MD5 = 5,         /**< EAP phase2 authentication MD5 */
 235 } wifi_eap_auth_type_e;
 236
 237 /**
 238 * @}
 239 */
 240
 241
 242 /**
 243 * @addtogroup CAPI_NETWORK_WIFI_AP_MODULE
 244 * @{
 245 */
 246
 247 /**
 248  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_h instead.
 249  * @brief The Wi-Fi access point handle.
 250  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 251  */
 252 typedef void* wifi_ap_h;
 253
 254 /**
 255 * @}
 256 */
 257
 258 /**
 259 * @addtogroup CAPI_NETWORK_WIFI_CONFIG_MODULE
 260 * @{
 261 */
 262
 263 /**
 264  * @deprecated Deprecated since 3.0. Use wifi_manager_config_h instead.
 265  * @brief The Wi-Fi access point configuration handle
 266  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 267  */
 268 typedef void *wifi_config_h;
 269
 270 /**
 271 * @}
 272 */
 273
 274 /**
 275 * @addtogroup CAPI_NETWORK_WIFI_MANAGEMENT_MODULE
 276 * @{
 277 */
 278
 279 /**
 280  * @deprecated Deprecated since 3.0. Use wifi_manager_found_ap_cb instead.
 281  * @brief Called when you get the found access point repeatedly.
 282  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 283  * @remarks @a ap is valid only in this function. In order to use @a ap outside this function, you must copy the ap with wifi_ap_clone().
 284  * @param[in]  ap  The access point
 285  * @param[in]  user_data  The user data passed from the request function
 286  * @return  @c true to continue with the next iteration of the loop, \n
 287  *          otherwise @c false to break out of the loop
 288  * @pre  wifi_foreach_found_aps() will invoke this callback.
 289  * @pre  wifi_foreach_found_specific_aps() will invoke this callback.
 290  * @see  wifi_foreach_found_aps()
 291  * @see  wifi_foreach_found_specific_aps()
 292  */
 293 typedef bool(*wifi_found_ap_cb)(wifi_ap_h ap, void *user_data);
 294
 295 /**
 296  * @deprecated Deprecated since 3.0. Use wifi_manager_scan_finished_cb instead.
 297  * @brief Called when the scan is finished.
 298  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 299  * @param[in] error_code  The error code
 300  * @param[in] user_data The user data passed from the callback registration function
 301  * @see wifi_scan()
 302  * @see wifi_set_background_scan_cb()
 303  * @see wifi_unset_background_scan_cb()
 304  */
 305 typedef void(*wifi_scan_finished_cb)(wifi_error_e error_code, void *user_data);
 306
 307 /**
 308  * @deprecated Deprecated since 3.0. Use wifi_manager_activated_cb instead.
 309  * @brief Called after wifi_activate() or wifi_activate_with_wifi_picker_tested() is completed.
 310  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 311  * @param[in] result  The result
 312  * @param[in] user_data The user data passed from wifi_activate() and wifi_activate_with_wifi_picker_tested()
 313  * @pre wifi_activate() or wifi_activate_with_wifi_picker_tested() will invoke this callback function.
 314  * @see wifi_activate()
 315  * @see wifi_activate_with_wifi_picker_tested()
 316  */
 317 typedef void(*wifi_activated_cb)(wifi_error_e result, void *user_data);
 318
 319 /**
 320  * @deprecated Deprecated since 3.0. Use wifi_manager_deactivated_cb instead.
 321  * @brief Called after wifi_deactivate() is completed.
 322  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 323  * @param[in] result  The result
 324  * @param[in] user_data The user data passed from wifi_deactivate()
 325  * @pre wifi_deactivate() will invoke this callback function.
 326  * @see wifi_deactivate()
 327  */
 328 typedef void(*wifi_deactivated_cb)(wifi_error_e result, void *user_data);
 329
 330 /**
 331  * @deprecated Deprecated since 3.0. Use wifi_manager_connected_cb instead.
 332  * @brief Called after either wifi_connect() or wifi_connect_by_wps_pbc() or wifi_connect_by_wps_pin() are completed.
 333  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 334  * @param[in] result  The result
 335  * @param[in] user_data The user data passed from either wifi_connect() or wifi_connect_by_wps_pbc() or wifi_connect_by_wps_pin()
 336  * @pre Either wifi_connect() or wifi_connect_by_wps_pbc() or wifi_connect_by_wps_pin() will invoke this callback function.
 337  * @see wifi_connect()
 338  * @see wifi_connect_by_wps_pbc()
 339  * @see wifi_connect_by_wps_pin()
 340  */
 341 typedef void(*wifi_connected_cb)(wifi_error_e result, void *user_data);
 342
 343 /**
 344  * @deprecated Deprecated since 3.0. Use wifi_manager_disconnected_cb instead.
 345  * @brief Called after wifi_disconnect() is completed.
 346  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 347  * @param[in] result  The result
 348  * @param[in] user_data The user data passed from wifi_disconnect()
 349  * @pre wifi_disconnect() will invoke this callback function.
 350  * @see wifi_disconnect()
 351  */
 352 typedef void(*wifi_disconnected_cb)(wifi_error_e result, void *user_data);
 353
 354 /**
 355 * @}
 356 */
 357
 358
 359 /**
 360 * @addtogroup CAPI_NETWORK_WIFI_MONITOR_MODULE
 361 * @{
 362 */
 363
 364 /**
 365  * @deprecated Deprecated since 3.0. Use wifi_manager_device_state_changed_cb instead.
 366  * @brief Called when the device state is changed.
 367  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 368  * @param[in] state  The device state
 369  * @param[in] user_data The user data passed from the callback registration function
 370  * @see wifi_set_device_state_changed_cb()
 371  * @see wifi_unset_device_state_changed_cb()
 372  */
 373 typedef void(*wifi_device_state_changed_cb)(wifi_device_state_e state, void *user_data);
 374
 375 /**
 376  * @deprecated Deprecated since 3.0. Use wifi_manager_connection_state_changed_cb instead.
 377  * @brief Called when the connection state is changed.
 378  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 379  * @param[in] state  The connection state
 380  * @param[in] ap  The access point
 381  * @param[in] user_data The user data passed from the callback registration function
 382  * @see wifi_set_connection_state_changed_cb()
 383  * @see wifi_unset_connection_state_changed_cb()
 384  */
 385 typedef void(*wifi_connection_state_changed_cb)(wifi_connection_state_e state, wifi_ap_h ap, void *user_data);
 386
 387 /**
 388  * @deprecated Deprecated since 3.0. Use wifi_manager_rssi_level_changed_cb instead.
 389  * @brief Called when the RSSI of connected Wi-Fi is changed.
 390  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 391  * @param[in] rssi_level  The level of RSSI
 392  * @param[in] user_data The user data passed from the callback registration function
 393  * @see wifi_set_rssi_level_changed_cb()
 394  * @see wifi_unset_rssi_level_changed_cb()
 395  */
 396 typedef void(*wifi_rssi_level_changed_cb)(wifi_rssi_level_e rssi_level, void *user_data);
 397
 398 /**
 399 * @}
 400 */
 401
 402 /**
 403 * @addtogroup CAPI_NETWORK_WIFI_CONFIG_MODULE
 404 * @{
 405 */
 406
 407 /**
 408  * @deprecated Deprecated since 3.0. Use wifi_manager_config_list_cb instead.
 409  * @brief Called when you get the found access point configurations repeatedly.
 410  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 411  * @remarks @a config is valid only in this function. In order to use @a config outside this function, you must copy the config with wifi_config_clone().
 412  *
 413  * @param[in]  config           The access point configuration handle
 414  * @param[in]  user_data        The user data passed from the request function
 415  *
 416  * @return  @c true to continue with the next iteration of the loop, otherwise @c false to break out of the loop \n
 417  * @pre  wifi_config_foreach_configuration() will invoke this callback.
 418  * @see  wifi_config_foreach_configuration()
 419  */
 420 typedef bool (*wifi_config_list_cb)(const wifi_config_h config, void *user_data);
 421
 422 /**
 423 * @}
 424 */
 425
 426 /**
 427 * @addtogroup CAPI_NETWORK_WIFI_MODULE
 428 * @{
 429 */
 430
 431 /**
 432  * @deprecated Deprecated since 3.0. Use wifi_manager_initialize() instead.
 433  * @brief Initializes Wi-Fi.
 434  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 435  * @privlevel public
 436  * @privilege %http://tizen.org/privilege/network.get
 437  * @return @c 0 on success, otherwise negative error value
 438  * @retval #WIFI_ERROR_NONE  Successful
 439  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 440  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 441  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 442  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 443  */
 444 int wifi_initialize(void) TIZEN_DEPRECATED_API;
 445
 446 /**
 447  * @deprecated Deprecated since 3.0. Use wifi_manager_deinitialize() instead.
 448  * @brief Deinitializes Wi-Fi.
 449  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 450  * @return 0 on success, otherwise negative error value
 451  * @retval #WIFI_ERROR_NONE  Successful
 452  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 453  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 454  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 455  */
 456 int wifi_deinitialize(void) TIZEN_DEPRECATED_API;
 457
 458 /**
 459 * @}
 460 */
 461
 462
 463 /**
 464 * @addtogroup CAPI_NETWORK_WIFI_MANAGEMENT_MODULE
 465 * @{
 466 */
 467
 468 /**
 469  * @deprecated Deprecated since 3.0. Use wifi_manager_activate() instead.
 470  * @brief Activates Wi-Fi asynchronously.
 471  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 472  * @privlevel public
 473  * @privilege %http://tizen.org/privilege/network.set \n
 474  *            %http://tizen.org/privilege/network.get
 475  * @remark This API needs both privileges.
 476  * @param[in] callback  The callback function to be called \n
 477  *                      This can be @c NULL if you don't want to get the notification.
 478  * @param[in] user_data The user data passed to the callback function
 479  * @return 0 on success, otherwise negative error value
 480  * @retval #WIFI_ERROR_NONE  Successful
 481  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 482  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 483  * @retval #WIFI_ERROR_SECURITY_RESTRICTED  Restricted by security system policy
 484  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 485  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 486  * @post wifi_activated_cb() will be invoked.
 487  * @see wifi_activated_cb()
 488  * @see wifi_deactivate()
 489  */
 490 int wifi_activate(wifi_activated_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 491
 492 /**
 493  * @deprecated Deprecated since 3.0. Use wifi_manager_activate_with_wifi_picker_tested() instead.
 494  * @brief Activates Wi-Fi asynchronously and displays Wi-Fi picker (popup) when Wi-Fi is not automatically connected.
 495  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 496  * @privlevel public
 497  * @privilege %http://tizen.org/privilege/network.set \n
 498  *            %http://tizen.org/privilege/network.get
 499  * @remark This API needs both privileges.
 500  * @param[in] callback  The callback function to be called \n
 501  *                      This can be @c NULL if you don't want to get the notification.
 502  * @param[in] user_data The user data passed to the callback function
 503  * @return 0 on success, otherwise negative error value
 504  * @retval #WIFI_ERROR_NONE  Successful
 505  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 506  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 507  * @retval #WIFI_ERROR_SECURITY_RESTRICTED  Restricted by security system policy
 508  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 509  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 510  * @post wifi_activated_cb() will be invoked.
 511  * @see wifi_activated_cb()
 512  * @see wifi_deactivate()
 513  */
 514 int wifi_activate_with_wifi_picker_tested(wifi_activated_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 515
 516 /**
 517  * @deprecated Deprecated since 3.0. Use wifi_manager_deactivate() instead.
 518  * @brief Deactivates Wi-Fi asynchronously.
 519  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 520  * @privlevel public
 521  * @privilege %http://tizen.org/privilege/network.set \n
 522  *            %http://tizen.org/privilege/network.get
 523  * @remark This API needs both privileges.
 524  * @param[in] callback  The callback function to be called \n
 525  *                      This can be @c NULL if you don't want to get the notification.
 526  * @param[in] user_data The user data passed to the callback function
 527  * @return 0 on success, otherwise negative error value
 528  * @retval #WIFI_ERROR_NONE  Successful
 529  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 530  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 531  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 532  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 533  * @post wifi_deactivated_cb() will be invoked.
 534  * @see wifi_deactivated_cb()
 535  * @see wifi_activate()
 536  */
 537 int wifi_deactivate(wifi_deactivated_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 538
 539 /**
 540  * @deprecated Deprecated since 3.0. Use wifi_manager_is_activated() instead.
 541  * @brief Checks whether Wi-Fi is activated.
 542  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 543  * @privlevel public
 544  * @privilege %http://tizen.org/privilege/network.get
 545  * @param[out] activated  @c ture if Wi-Fi is activated,
 546  *                        otherwise @c false if Wi-Fi is not activated.
 547  * @return 0 on success, otherwise negative error value
 548  * @retval #WIFI_ERROR_NONE  Successful
 549  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 550  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 551  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 552  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 553  */
 554 int wifi_is_activated(bool* activated) TIZEN_DEPRECATED_API;
 555
 556 /**
 557  * @deprecated Deprecated since 3.0. Use wifi_manager_get_mac_address() instead.
 558  * @brief Gets the local MAC address.
 559  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 560  * @remarks You must release @a mac_address using free().
 561  * @param[out] mac_address  The MAC address
 562  * @return 0 on success, otherwise negative error value
 563  * @retval #WIFI_ERROR_NONE  Successful
 564  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 565  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 566  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 567  */
 568 int wifi_get_mac_address(char** mac_address) TIZEN_DEPRECATED_API;
 569
 570 /**
 571  * @deprecated Deprecated since 3.0. Use wifi_manager_get_network_interface_name() instead.
 572  * @brief Gets the name of the network interface.
 573  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 574  * @privlevel public
 575  * @privilege %http://tizen.org/privilege/network.get
 576  * @remarks You must release @a name using free().
 577  * @param[out] name  The name of network interface
 578  * @return 0 on success, otherwise negative error value
 579  * @retval #WIFI_ERROR_NONE  Successful
 580  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 581  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
 582  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 583  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 584  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 585  */
 586 int wifi_get_network_interface_name(char** name) TIZEN_DEPRECATED_API;
 587
 588 /**
 589  * @deprecated Deprecated since 3.0. Use wifi_manager_scan() instead.
 590  * @brief Starts scan asynchronously.
 591  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 592  * @privlevel public
 593  * @privilege %http://tizen.org/privilege/network.set \n
 594  *            %http://tizen.org/privilege/network.get
 595  * @remark This API needs both privileges.
 596  * @param[in] callback  The callback function to be called
 597  * @param[in] user_data The user data passed to the callback function
 598  * @return 0 on success, otherwise negative error value
 599  * @retval #WIFI_ERROR_NONE  Successful
 600  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 601  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 602  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 603  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 604  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 605  * @post This function invokes wifi_scan_finished_cb().
 606  */
 607 int wifi_scan(wifi_scan_finished_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 608
 609 /**
 610  * @deprecated Deprecated since 3.0. Use wifi_manager_scan_specific_ap() instead.
 611  * @brief Starts specific ap scan, asynchronously.
 612  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0
 613  * @privlevel public
 614  * @privilege %http://tizen.org/privilege/network.set \n
 615  *               %http://tizen.org/privilege/network.get
 616  * @remark This API needs both privileges.
 617  * @param[in] essid     The essid of hidden ap
 618  * @param[in] callback  The callback function to be called
 619  * @param[in] user_data The user data passed to the callback function
 620  * @return 0 on success, otherwise negative error value.
 621  * @retval #WIFI_ERROR_NONE  Successful
 622  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 623  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 624  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 625  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 626  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 627  * @post This function invokes wifi_scan_finished_cb().
 628  */
 629 int wifi_scan_specific_ap(const char* essid, wifi_scan_finished_cb callback, void* user_data) TIZEN_DEPRECATED_API;
 630
 631 /**
 632  * @deprecated Deprecated since 3.0. Use wifi_manager_get_connected_ap() instead.
 633  * @brief Gets the handle of the connected access point.
 634  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 635  * @privlevel public
 636  * @privilege %http://tizen.org/privilege/network.get
 637  * @remarks You must release @a handle using wifi_ap_destroy().
 638  * @param[out] ap  The access point handle
 639  * @return 0 on success, otherwise negative error value
 640  * @retval #WIFI_ERROR_NONE  Successful
 641  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 642  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
 643  * @retval #WIFI_ERROR_NO_CONNECTION  There is no connected AP
 644  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 645  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 646  */
 647 int wifi_get_connected_ap(wifi_ap_h* ap) TIZEN_DEPRECATED_API;
 648
 649 /**
 650  * @deprecated Deprecated since 3.0. Use wifi_manager_foreach_found_ap() instead.
 651  * @brief Gets the result of the scan.
 652  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 653  * @privlevel public
 654  * @privilege %http://tizen.org/privilege/network.get
 655  * @param[in] callback  The callback to be called
 656  * @param[in] user_data The user data passed to the callback function
 657  * @return 0 on success, otherwise negative error value
 658  * @retval #WIFI_ERROR_NONE  Successful
 659  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 660  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 661  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 662  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 663  * @post This function invokes wifi_found_ap_cb().
 664  */
 665 int wifi_foreach_found_aps(wifi_found_ap_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 666
 667 /**
 668  * @deprecated Deprecated since 3.0. Use wifi_manager_foreach_found_specific_ap() instead.
 669  * @brief Gets the result of specific ap scan.
 670  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0
 671  * @privlevel public
 672  * @privilege %http://tizen.org/privilege/network.get
 673  * @param[in] callback  The callback to be called
 674  * @param[in] user_data The user data passed to the callback function
 675  * @return 0 on success, otherwise negative error value.
 676  * @retval #WIFI_ERROR_NONE  Successful
 677  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 678  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 679  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 680  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 681  * @post This function invokes wifi_found_ap_cb().
 682  * @see wifi_scan_specific_ap()
 683  */
 684 int wifi_foreach_found_specific_aps(wifi_found_ap_cb callback, void* user_data) TIZEN_DEPRECATED_API;
 685
 686 /**
 687  * @deprecated Deprecated since 3.0. Use wifi_manager_connect() instead.
 688  * @brief Connects the access point asynchronously.
 689  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 690  * @privlevel public
 691  * @privilege %http://tizen.org/privilege/network.set \n
 692  *            %http://tizen.org/privilege/network.get
 693  * @remark This API needs both privileges.
 694  * @param[in] ap  The access point handle
 695  * @param[in] callback  The callback function to be called \n
 696  *                      This can be @c NULL if you don't want to get the notification.
 697  * @param[in] user_data The user data passed to the callback function
 698  * @return 0 on success, otherwise negative error value
 699  * @retval #WIFI_ERROR_NONE  Successful
 700  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 701  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 702  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 703  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 704  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 705  * @post This function invokes wifi_connected_cb().
 706  * @see wifi_connected_cb()
 707  * @see wifi_connect_by_wps_pbc()
 708  * @see wifi_connect_by_wps_pin()
 709  * @see wifi_disconnect()
 710  */
 711 int wifi_connect(wifi_ap_h ap, wifi_connected_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 712
 713 /**
 714  * @deprecated Deprecated since 3.0. Use wifi_manager_disconnect() instead.
 715  * @brief Disconnects the access point asynchronously.
 716  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 717  * @privlevel public
 718  * @privilege %http://tizen.org/privilege/network.set \n
 719  *            %http://tizen.org/privilege/network.get
 720  * @remark This API needs both privileges.
 721  * @param[in] ap  The access point handle
 722  * @param[in] callback  The callback function to be called \n
 723  *                      This can be @c NULL if you don't want to get the notification.
 724  * @param[in] user_data The user data passed to the callback function
 725  * @return 0 on success, otherwise negative error value
 726  * @retval #WIFI_ERROR_NONE  Successful
 727  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 728  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 729  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 730  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 731  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 732  * @post This function invokes wifi_disconnected_cb().
 733  * @see wifi_disconnected_cb()
 734  * @see wifi_connect_by_wps_pbc()
 735  * @see wifi_connect_by_wps_pin()
 736  * @see wifi_connect()
 737  */
 738 int wifi_disconnect(wifi_ap_h ap, wifi_disconnected_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 739
 740 /**
 741  * @deprecated Deprecated since 3.0. Use wifi_manager_connect_by_wps_pbc() instead.
 742  * @brief Connects the access point with WPS PBC asynchronously.
 743  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 744  * @privlevel public
 745  * @privilege %http://tizen.org/privilege/network.profile \n
 746  *            %http://tizen.org/privilege/network.get
 747  * @remark This API needs both privileges.
 748  * @param[in] ap  The access point handle
 749  * @param[in] callback  The callback function to be called \n
 750  *                      This can be NULL if you don't want to get the notification.
 751  * @param[in] user_data The user data passed to the callback function
 752  * @return 0 on success, otherwise negative error value
 753  * @retval #WIFI_ERROR_NONE  Successful
 754  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 755  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 756  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 757  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 758  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 759  * @post This function invokes wifi_connected_cb().
 760  * @see wifi_connected_cb()
 761  * @see wifi_connect()
 762  * @see wifi_disconnect()
 763  * @see wifi_ap_is_wps_supported()
 764  */
 765 int wifi_connect_by_wps_pbc(wifi_ap_h ap, wifi_connected_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 766
 767 /**
 768  * @deprecated Deprecated since 3.0. Use wifi_manager_connect_by_wps_pin() instead.
 769  * @brief Connects the access point with WPS PIN asynchronously.
 770  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 771  * @privlevel public
 772  * @privilege %http://tizen.org/privilege/network.profile \n
 773  *            %http://tizen.org/privilege/network.get
 774  * @remark This API needs both privileges.
 775  * @param[in] ap  The access point handle
 776  * @param[in] pin  The WPS PIN is a non-NULL string with length greater than 0 and less than or equal to 8
 777  * @param[in] callback  The callback function to be called (this can be NULL if you don't want to get the notification)
 778  * @param[in] user_data The user data passed to the callback function
 779  * @return 0 on success, otherwise negative error value
 780  * @retval #WIFI_ERROR_NONE  Successful
 781  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 782  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 783  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 784  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 785  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 786  * @post This function invokes wifi_connected_cb().
 787  * @see wifi_connected_cb()
 788  * @see wifi_connect()
 789  * @see wifi_disconnect()
 790  * @see wifi_ap_is_wps_supported()
 791  */
 792 int wifi_connect_by_wps_pin(wifi_ap_h ap, const char *pin, wifi_connected_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 793
 794 /**
 795  * @deprecated Deprecated since 3.0. Use wifi_manager_forget_ap() instead.
 796  * @brief Deletes the information of stored access point and disconnects it when it connected.
 797  * @details If an AP is connected, then connection information will be stored.
 798  * This information is used when a connection to that AP is established automatically.
 799  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 800  * @privlevel public
 801  * @privilege %http://tizen.org/privilege/network.profile \n
 802 *             %http://tizen.org/privilege/network.get
 803  * @remark This API needs both privileges.
 804  * @param[in] ap  The access point handle
 805  * @return 0 on success, otherwise negative error value
 806  * @retval #WIFI_ERROR_NONE  Successful
 807  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 808  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 809  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 810  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 811  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 812  */
 813 int wifi_forget_ap(wifi_ap_h ap) TIZEN_DEPRECATED_API;
 814
 815 /**
 816 * @}
 817 */
 818
 819
 820 /**
 821 * @addtogroup CAPI_NETWORK_WIFI_MONITOR_MODULE
 822 * @{
 823 */
 824
 825 /**
 826  * @deprecated Deprecated since 3.0. Use wifi_manager_get_connection_state() instead.
 827  * @brief Gets the connection state.
 828  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 829  * @privlevel public
 830  * @privilege %http://tizen.org/privilege/network.get
 831  * @param[out] connection_state  The connection state
 832  * @return 0 on success, otherwise negative error value
 833  * @retval #WIFI_ERROR_NONE  Successful
 834  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 835  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
 836  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 837  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 838  */
 839 int wifi_get_connection_state(wifi_connection_state_e* connection_state) TIZEN_DEPRECATED_API;
 840
 841 /**
 842  * @deprecated Deprecated since 3.0. Use wifi_manager_set_device_state_changed_cb() instead.
 843  * @brief Registers the callback called when the device state is changed.
 844  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 845  * @param[in] callback  The callback function to be called
 846  * @param[in] user_data The user data passed to the callback function
 847  * @return 0 on success, otherwise negative error value
 848  * @retval #WIFI_ERROR_NONE  Successful
 849  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 850  * @retval #WIFI_ERROR_INVALID_PARAMETER   Invalid parameter
 851  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 852  */
 853 int wifi_set_device_state_changed_cb(wifi_device_state_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 854
 855 /**
 856  * @deprecated Deprecated since 3.0. Use wifi_manager_unset_device_state_changed_cb() instead.
 857  * @brief Unregisters the callback called when the device state is changed.
 858  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 859  * @return 0 on success, otherwise negative error value
 860  * @retval #WIFI_ERROR_NONE  Successful
 861  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 862  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 863  */
 864 int wifi_unset_device_state_changed_cb(void) TIZEN_DEPRECATED_API;
 865
 866 /**
 867  * @deprecated Deprecated since 3.0. Use wifi_manager_set_background_scan_cb() instead.
 868  * @brief Registers the callback called when the background scan is finished periodically.
 869  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 870  * @param[in] callback  The callback function to be called
 871  * @param[in] user_data The user data passed to the callback function
 872  * @return 0 on success, otherwise negative error value
 873  * @retval #WIFI_ERROR_NONE  Successful
 874  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 875  * @retval #WIFI_ERROR_INVALID_PARAMETER   Invalid parameter
 876  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 877  */
 878 int wifi_set_background_scan_cb(wifi_scan_finished_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 879
 880 /**
 881  * @deprecated Deprecated since 3.0. Use wifi_manager_unset_background_scan_cb() instead.
 882  * @brief Unregisters the callback called when the scan is finished periodically.
 883  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 884  * @return 0 on success, otherwise negative error value
 885  * @retval #WIFI_ERROR_NONE  Successful
 886  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 887  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 888  */
 889 int wifi_unset_background_scan_cb(void) TIZEN_DEPRECATED_API;
 890
 891 /**
 892  * @deprecated Deprecated since 3.0. Use wifi_manager_set_connection_state_changed_cb() instead.
 893  * @brief Registers the callback called when the connection state is changed.
 894  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 895  * @param[in] callback  The callback function to be called
 896  * @param[in] user_data The user data passed to the callback function
 897  * @return 0 on success, otherwise negative error value
 898  * @retval #WIFI_ERROR_NONE  Successful
 899  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 900  * @retval #WIFI_ERROR_INVALID_PARAMETER   Invalid parameter
 901  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 902  */
 903 int wifi_set_connection_state_changed_cb(wifi_connection_state_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 904
 905 /**
 906  * @deprecated Deprecated since 3.0. Use wifi_manager_unset_connection_state_changed_cb() instead.
 907  * @brief Unregisters the callback called when the connection state is changed.
 908  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 909  * @return 0 on success, otherwise negative error value
 910  * @retval #WIFI_ERROR_NONE  Successful
 911  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 912  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 913  */
 914 int wifi_unset_connection_state_changed_cb(void) TIZEN_DEPRECATED_API;
 915
 916 /**
 917  * @deprecated Deprecated since 3.0. Use wifi_manager_set_rssi_level_changed_cb() instead.
 918  * @brief Registers callback called when the RSSI of connected Wi-Fi is changed.
 919  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 920  * @param[in] callback  The callback function to be called
 921  * @param[in] user_data The user data passed to the callback function
 922  * @return 0 on success, otherwise negative error value
 923  * @retval #WIFI_ERROR_NONE  Successful
 924  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 925  * @retval #WIFI_ERROR_INVALID_PARAMETER   Invalid parameter
 926  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 927  */
 928 int wifi_set_rssi_level_changed_cb(wifi_rssi_level_changed_cb callback, void *user_data) TIZEN_DEPRECATED_API;
 929
 930 /**
 931  * @deprecated Deprecated since 3.0. Use wifi_manager_unset_rssi_level_changed_cb() instead.
 932  * @brief Unregisters callback called when the RSSI of connected Wi-Fi is changed.
 933  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 934  * @return 0 on success, otherwise negative error value
 935  * @retval #WIFI_ERROR_NONE  Successful
 936  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
 937  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 938  */
 939 int wifi_unset_rssi_level_changed_cb(void) TIZEN_DEPRECATED_API;
 940
 941 /**
 942 * @}
 943 */
 944
 945
 946 /**
 947 * @addtogroup CAPI_NETWORK_WIFI_AP_MODULE
 948 * @{
 949 */
 950
 951 /**
 952  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_create() instead.
 953  * @brief Creates the access point handle.
 954  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 955  * @remarks You must release @a ap using wifi_ap_destroy().
 956  * @param[in] essid  The ESSID (Extended Service Set Identifier) should be null-terminated and can be UTF-8 encoded
 957  * @param[out] ap  The access point handle
 958  * @return 0 on success, otherwise negative error value
 959  * @retval #WIFI_ERROR_NONE  Successful
 960  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 961  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
 962  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
 963  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 964  * @see wifi_ap_destroy()
 965  */
 966 int wifi_ap_create(const char* essid, wifi_ap_h* ap) TIZEN_DEPRECATED_API;
 967
 968 /**
 969  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_hidden_create() instead.
 970  * @brief Creates the hidden access point handle.
 971  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 972  * @remarks You must release @a ap using wifi_ap_destroy().
 973  * @param[in] essid  The ESSID (Extended Service Set Identifier) should be null-terminated and can be UTF-8 encoded
 974  * @param[out] ap  The access point handle
 975  * @return 0 on success, otherwise negative error value
 976  * @retval #WIFI_ERROR_NONE  Successful
 977  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 978  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
 979  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 980  * @see wifi_ap_destroy()
 981  */
 982 int wifi_ap_hidden_create(const char* essid, wifi_ap_h* ap) TIZEN_DEPRECATED_API;
 983
 984 /**
 985  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_destroy() instead.
 986  * @brief Destroys the access point handle.
 987  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 988  * @param[in] ap  The access point handle
 989  * @return 0 on success, otherwise negative error value
 990  * @retval #WIFI_ERROR_NONE  Successful
 991  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
 992  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
 993  * @see wifi_ap_create()
 994  */
 995 int wifi_ap_destroy(wifi_ap_h ap) TIZEN_DEPRECATED_API;
 996
 997 /**
 998  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_clone() instead.
 999  * @brief Clones the access point handle.
1000  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1001  * @remarks You must release @a cloned_ap using wifi_ap_destroy().
1002  * @param[out] cloned_ap  The cloned access point handle
1003  * @param[in] origin  The origin access point handle
1004  * @return 0 on success, otherwise negative error value
1005  * @retval #WIFI_ERROR_NONE  Successful
1006  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1007  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
1008  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
1009  * @see wifi_ap_destroy()
1010  */
1011 int wifi_ap_clone(wifi_ap_h* cloned_ap, wifi_ap_h origin) TIZEN_DEPRECATED_API;
1012
1013 /**
1014  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_refresh() instead.
1015  * @brief Refreshes the access point information.
1016  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1017  * @privlevel public
1018  * @privilege %http://tizen.org/privilege/network.get
1019  * @remarks You should call this function in order to get the current access point information, because the information can be changed.
1020  * @param[in] ap  The access point handle
1021  * @return 0 on success, otherwise negative error value
1022  * @retval #WIFI_ERROR_NONE  Successful
1023  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1024  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1025  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
1026  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
1027  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
1028  */
1029 int wifi_ap_refresh(wifi_ap_h ap) TIZEN_DEPRECATED_API;
1030
1031 /**
1032 * @}
1033 */
1034
1035
1036 /**
1037 * @addtogroup CAPI_NETWORK_WIFI_AP_NETWORK_MODULE
1038 * @{
1039 */
1040
1041 /**
1042  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_essid() instead.
1043  * @brief Gets ESSID (Extended Service Set Identifier).
1044  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1045  * @remarks You must release @a essid using free().
1046  * @param[in] ap  The access point handle
1047  * @param[out] essid  The ESSID
1048  * @return 0 on success, otherwise negative error value
1049  * @retval #WIFI_ERROR_NONE  Successful
1050  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1051  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
1052  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
1053  */
1054 int wifi_ap_get_essid(wifi_ap_h ap, char** essid) TIZEN_DEPRECATED_API;
1055
1056 /**
1057  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_bssid() instead.
1058  * @brief Gets BSSID (Basic Service Set Identifier).
1059  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1060  * @remarks You must release @a bssid using free().
1061  * @param[in] ap  The access point handle
1062  * @param[out] bssid  The BSSID
1063  * @return 0 on success, otherwise negative error value
1064  * @retval #WIFI_ERROR_NONE  Successful
1065  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1066  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
1067  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
1068  */
1069 int wifi_ap_get_bssid(wifi_ap_h ap, char** bssid) TIZEN_DEPRECATED_API;
1070
1071 /**
1072  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_rssi() instead.
1073  * @brief Gets the RSSI.
1074  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1075  * @param[in] ap  The access point handle
1076  * @param[out] rssi  The RSSI
1077  * @return 0 on success, otherwise negative error value
1078  * @retval #WIFI_ERROR_NONE  Successful
1079  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1080  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1081  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
1082  */
1083 int wifi_ap_get_rssi(wifi_ap_h ap, int* rssi) TIZEN_DEPRECATED_API;
1084
1085 /**
1086  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_frequency() instead.
1087  * @brief Gets the frequency band (MHz).
1088  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1089  * @param[in] ap  The access point handle
1090  * @param[out] frequency  The frequency
1091  * @return 0 on success, otherwise negative error value
1092  * @retval #WIFI_ERROR_NONE  Successful
1093  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1094  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1095  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
1096  */
1097 int wifi_ap_get_frequency(wifi_ap_h ap, int* frequency) TIZEN_DEPRECATED_API;
1098
1099 /**
1100  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_max_speed() instead.
1101  * @brief Gets the max speed (Mbps).
1102  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1103  * @param[in] ap  The access point handle
1104  * @param[out] max_speed  The max speed
1105  * @return 0 on success, otherwise negative error value
1106  * @retval #WIFI_ERROR_NONE  Successful
1107  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1108  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1109  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
1110  */
1111 int wifi_ap_get_max_speed(wifi_ap_h ap, int* max_speed) TIZEN_DEPRECATED_API;
1112
1113 /**
1114  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_is_favorite() instead.
1115  * @brief Checks whether the access point is favorite or not.
1116  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1117  * @param[in] ap  The access point handle
1118  * @param[out] favorite  @c true if access point is favorite,
1119  *                       otherwise @c false if access point is not favorite
1120  * @return 0 on success, otherwise negative error value
1121  * @retval #WIFI_ERROR_NONE  Successful
1122  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1123  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1124  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
1125  */
1126 int wifi_ap_is_favorite(wifi_ap_h ap, bool* favorite) TIZEN_DEPRECATED_API;
1127
1128 /**
1129  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_is_passpoint() instead.
1130  * @brief Checks whether the access point is passpoint or not.
1131  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1132  * @param[in] ap  The access point handle
1133  * @param[out] passpoint  @c ture if access point is passpoint,
1134  *                        otherwise @c false if access point is not passpoint.
1135  * @return 0 on success, otherwise negative error value
1136  * @retval #WIFI_ERROR_NONE  Successful
1137  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1138  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1139  * @retval #WIFI_ERROR_NOT_SUPPORTED    Not supported
1140  */
1141 int wifi_ap_is_passpoint(wifi_ap_h ap, bool* passpoint) TIZEN_DEPRECATED_API;
1142
1143 /**
1144  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_connection_state() instead.
1145  * @brief Gets the connection state.
1146  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1147  * @param[in] ap  The access point handle
1148  * @param[out] state  The connection state
1149  * @return 0 on success, otherwise negative error value
1150  * @retval #WIFI_ERROR_NONE  Successful
1151  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1152  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1153  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1154  */
1155 int wifi_ap_get_connection_state(wifi_ap_h ap, wifi_connection_state_e* state) TIZEN_DEPRECATED_API;
1156
1157 /**
1158  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_ip_config_type() instead.
1159  * @brief Gets the config type of IP.
1160  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1161  * @param[in] ap  The access point handle
1162  * @param[in] address_family  The address family
1163  * @param[out] type  The type of IP config
1164  * @return 0 on success, otherwise negative error value
1165  * @retval #WIFI_ERROR_NONE  Successful
1166  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1167  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1168  * @retval #WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED  Address family not supported
1169  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1170  */
1171 int wifi_ap_get_ip_config_type(wifi_ap_h ap, wifi_address_family_e address_family, wifi_ip_config_type_e* type) TIZEN_DEPRECATED_API;
1172
1173 /**
1174  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_set_ip_config_type() instead.
1175  * @brief Sets the config type of IP.
1176  * @details If you set IP config type to #WIFI_IP_CONFIG_TYPE_STATIC,
1177  * then IP address, Gateway and Subnet mask will be set to the initial value "0.0.0.0".
1178  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1179  * @privlevel public
1180  * @privilege %http://tizen.org/privilege/network.profile \n
1181  *            %http://tizen.org/privilege/network.get
1182  * @remark This API needs both privileges.
1183  * @param[in] ap  The access point handle
1184  * @param[in] address_family  The address family
1185  * @param[in] type  The type of IP config
1186  * @return 0 on success, otherwise negative error value
1187  * @retval #WIFI_ERROR_NONE  Successful
1188  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1189  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1190  * @retval #WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED  Address family not supported
1191  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
1192  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1193  */
1194 int wifi_ap_set_ip_config_type(wifi_ap_h ap, wifi_address_family_e address_family, wifi_ip_config_type_e type) TIZEN_DEPRECATED_API;
1195
1196 /**
1197  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_ip_address() instead.
1198  * @brief Gets the IP address.
1199  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1200  * @remarks You must release @a ip_address using free().
1201  * @param[in] ap  The access point handle
1202  * @param[in] address_family  The address family
1203  * @param[out] ip_address  The IP address
1204  * @return 0 on success, otherwise negative error value
1205  * @retval #WIFI_ERROR_NONE  Successful
1206  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1207  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
1208  * @retval #WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED  Address family not supported
1209  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1210  */
1211 int wifi_ap_get_ip_address(wifi_ap_h ap, wifi_address_family_e address_family, char** ip_address) TIZEN_DEPRECATED_API;
1212
1213 /**
1214  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_set_ip_address() instead.
1215  * @brief Sets the IP address.
1216  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1217  * @privlevel public
1218  * @privilege %http://tizen.org/privilege/network.profile \n
1219  *            %http://tizen.org/privilege/network.get
1220  * @remark This API needs both privileges.
1221  * @param[in] ap  The access point handle
1222  * @param[in] address_family  The address family
1223  * @param[in] ip_address  The IP address; if you set this value to NULL, then the existing value will be deleted
1224  * @return 0 on success, otherwise negative error value
1225  * @retval #WIFI_ERROR_NONE  Successful
1226  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1227  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1228  * @retval #WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED  Address family not supported
1229  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
1230  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1231  */
1232 int wifi_ap_set_ip_address(wifi_ap_h ap, wifi_address_family_e address_family, const char* ip_address) TIZEN_DEPRECATED_API;
1233
1234 /**
1235  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_subnet_mask() instead.
1236  * @brief Gets the subnet mask.
1237  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1238  * @remarks You must release @a subnet_mask using free().
1239  * @param[in] ap  The access point handle
1240  * @param[in] address_family  The address family
1241  * @param[out] subnet_mask  The subnet mask
1242  * @return 0 on success, otherwise negative error value
1243  * @retval #WIFI_ERROR_NONE  Successful
1244  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1245  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
1246  * @retval #WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED  Address family not supported
1247  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1248  */
1249 int wifi_ap_get_subnet_mask(wifi_ap_h ap, wifi_address_family_e address_family, char** subnet_mask) TIZEN_DEPRECATED_API;
1250
1251 /**
1252  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_set_subnet_mask() instead.
1253  * @brief Sets the subnet mask.
1254  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1255  * @privlevel public
1256  * @privilege %http://tizen.org/privilege/network.profile \n
1257  *            %http://tizen.org/privilege/network.get
1258  * @remark This API needs both privileges.
1259  * @param[in] ap  The access point handle
1260  * @param[in] address_family  The address family
1261  * @param[in] subnet_mask  The subnet mask; if you set this value to NULL, then the existing value will be deleted
1262  * @return 0 on success, otherwise negative error value
1263  * @retval #WIFI_ERROR_NONE  Successful
1264  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1265  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1266  * @retval #WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED  Address family not supported
1267  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
1268  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1269  */
1270 int wifi_ap_set_subnet_mask(wifi_ap_h ap, wifi_address_family_e address_family, const char* subnet_mask) TIZEN_DEPRECATED_API;
1271
1272 /**
1273  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_gateway_address() instead.
1274  * @brief Gets the gateway address.
1275  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1276  * @remarks You must release @a gateway_address using free().
1277  * @param[in] ap  The access point handle
1278  * @param[in] address_family  The address family
1279  * @param[out] gateway_address  The gateway address
1280  * @return 0 on success, otherwise negative error value
1281  * @retval #WIFI_ERROR_NONE  Successful
1282  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1283  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
1284  * @retval #WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED  Address family not supported
1285  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1286  */
1287 int wifi_ap_get_gateway_address(wifi_ap_h ap, wifi_address_family_e address_family, char** gateway_address) TIZEN_DEPRECATED_API;
1288
1289 /**
1290  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_set_gateway_address() instead.
1291  * @brief Sets the gateway address.
1292  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1293  * @privlevel public
1294  * @privilege %http://tizen.org/privilege/network.profile \n
1295  *            %http://tizen.org/privilege/network.get
1296  * @remark This API needs both privileges.
1297  * @param[in] ap  The access point handle
1298  * @param[in] address_family  The address family
1299  * @param[in] gateway_address  The gateway address \n
1300  *                             If you set this value to @c NULL, then the existing value will be deleted.
1301  * @return 0 on success, otherwise negative error value
1302  * @retval #WIFI_ERROR_NONE  Successful
1303  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1304  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1305  * @retval #WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED  Address family not supported
1306  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
1307  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1308  */
1309 int wifi_ap_set_gateway_address(wifi_ap_h ap, wifi_address_family_e address_family, const char* gateway_address) TIZEN_DEPRECATED_API;
1310
1311 /**
1312  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_proxy_address() instead.
1313  * @brief Gets the proxy address.
1314  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1315  * @remarks You must release @a proxy_address using free().
1316  * @param[in] ap  The access point handle
1317  * @param[in] address_family  The address family
1318  * @param[out] proxy_address  The proxy address
1319  * @return 0 on success, otherwise negative error value
1320  * @retval #WIFI_ERROR_NONE  Successful
1321  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1322  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
1323  * @retval #WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED  Address family not supported
1324  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1325  */
1326 int wifi_ap_get_proxy_address(wifi_ap_h ap, wifi_address_family_e address_family, char** proxy_address) TIZEN_DEPRECATED_API;
1327
1328 /**
1329  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_set_proxy_address() instead.
1330  * @brief Sets the proxy address.
1331  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1332  * @privlevel public
1333  * @privilege %http://tizen.org/privilege/network.profile \n
1334  *            %http://tizen.org/privilege/network.get
1335  * @remark This API needs both privileges.
1336  * @param[in] ap  The access point handle
1337  * @param[in] address_family  The address family
1338  * @param[in] proxy_address  The proxy address \n
1339  *                           If you set this value to @c NULL, then the existing value will be deleted.
1340  * @return 0 on success, otherwise negative error value
1341  * @retval #WIFI_ERROR_NONE  Successful
1342  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1343  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1344  * @retval #WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED  Address family not supported
1345  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
1346  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1347  */
1348 int wifi_ap_set_proxy_address(wifi_ap_h ap, wifi_address_family_e address_family, const char* proxy_address) TIZEN_DEPRECATED_API;
1349
1350 /**
1351  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_proxy_type() instead.
1352  * @brief Gets the Proxy type.
1353  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1354  * @param[in] ap  The access point handle
1355  * @param[out] type  The type of proxy
1356  * @return 0 on success, otherwise negative error value
1357  * @retval #WIFI_ERROR_NONE  Successful
1358  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1359  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1360  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1361  */
1362 int wifi_ap_get_proxy_type(wifi_ap_h ap, wifi_proxy_type_e* type) TIZEN_DEPRECATED_API;
1363
1364 /**
1365  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_set_proxy_type() instead.
1366  * @brief Sets the Proxy address.
1367  * @details If you set Proxy type to #WIFI_PROXY_TYPE_AUTO or #WIFI_PROXY_TYPE_MANUAL, then Proxy will be restored.
1368  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1369  * @privlevel public
1370  * @privilege %http://tizen.org/privilege/network.profile \n
1371  *            %http://tizen.org/privilege/network.get
1372  * @remark This API needs both privileges.
1373  * @param[in] ap  The access point handle
1374  * @param[in] proxy_type  The type of proxy
1375  * @return 0 on success, otherwise negative error value
1376  * @retval #WIFI_ERROR_NONE  Successful
1377  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1378  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1379  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
1380  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1381  */
1382 int wifi_ap_set_proxy_type(wifi_ap_h ap, wifi_proxy_type_e proxy_type) TIZEN_DEPRECATED_API;
1383
1384 /**
1385  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_dns_address() instead.
1386  * @brief Gets the DNS address.
1387  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1388  * @remarks The allowance of DNS address is @c 2.You must release @a dns_address using free().
1389  * @param[in] ap  The access point handle
1390  * @param[in] order  The order of DNS address; it starts from 1, which means first DNS address
1391  * @param[in] address_family  The address family
1392  * @param[out] dns_address  The DNS address
1393  * @return 0 on success, otherwise negative error value
1394  * @retval #WIFI_ERROR_NONE  Successful
1395  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1396  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
1397  * @retval #WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED  Address family not supported
1398  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1399  */
1400 int wifi_ap_get_dns_address(wifi_ap_h ap, int order, wifi_address_family_e address_family, char** dns_address) TIZEN_DEPRECATED_API;
1401
1402 /**
1403  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_set_dns_address() instead.
1404  * @brief Sets the DNS address.
1405  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1406  * @privlevel public
1407  * @privilege %http://tizen.org/privilege/network.profile \n
1408  *            %http://tizen.org/privilege/network.get
1409  * @remarks The allowance of DNS address is @c 2 \n
1410  *          This API needs both privileges.
1411  * @param[in] ap  The access point handle
1412  * @param[in] order  The order of DNS address \n
1413  *                   It starts from @c 1, which means first DNS address.
1414  * @param[in] address_family  The address family
1415  * @param[in] dns_address  The DNS address \n
1416  *                         If you set this value to @c NULL, then the existing value will be deleted.
1417  * @return 0 on success, otherwise negative error value
1418  * @retval #WIFI_ERROR_NONE  Successful
1419  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1420  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1421  * @retval #WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED  Address family not supported
1422  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
1423  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1424  */
1425 int wifi_ap_set_dns_address(wifi_ap_h ap, int order, wifi_address_family_e address_family, const char* dns_address) TIZEN_DEPRECATED_API;
1426
1427 /**
1428 * @}
1429 */
1430
1431
1432 /**
1433 * @addtogroup CAPI_NETWORK_WIFI_AP_SECURITY_MODULE
1434 * @{
1435 */
1436
1437 /**
1438  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_security_type() instead.
1439  * @brief Gets the Wi-Fi security mode.
1440  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1441  * @param[in] ap  The access point handle
1442  * @param[out] type  The type of Wi-Fi security
1443  * @return 0 on success, otherwise negative error value
1444  * @retval #WIFI_ERROR_NONE  Successful
1445  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1446  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1447  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1448  */
1449 int wifi_ap_get_security_type(wifi_ap_h ap, wifi_security_type_e* type) TIZEN_DEPRECATED_API;
1450
1451 /**
1452  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_set_security_type() instead.
1453  * @brief Sets the Wi-Fi security mode.
1454  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1455  * @param[in] ap  The access point handle
1456  * @param[in] type  The type of Wi-Fi security
1457  * @return 0 on success, otherwise negative error value
1458  * @retval #WIFI_ERROR_NONE  Successful
1459  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1460  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1461  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1462  */
1463 int wifi_ap_set_security_type(wifi_ap_h ap, wifi_security_type_e type) TIZEN_DEPRECATED_API;
1464
1465 /**
1466  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_encryption_type() instead.
1467  * @brief Gets the Wi-Fi encryption type.
1468  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1469  * @param[in] ap  The access point handle
1470  * @param[out] type  The type of Wi-Fi encryption
1471  * @return 0 on success, otherwise negative error value
1472  * @retval #WIFI_ERROR_NONE  Successful
1473  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1474  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1475  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1476  */
1477 int wifi_ap_get_encryption_type(wifi_ap_h ap, wifi_encryption_type_e* type) TIZEN_DEPRECATED_API;
1478
1479 /**
1480  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_set_encryption_type() instead.
1481  * @brief Sets the Wi-Fi encryption type.
1482  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1483  * @param[in] ap  The access point handle
1484  * @param[in] type  The type of Wi-Fi encryption
1485  * @return 0 on success, otherwise negative error value
1486  * @retval #WIFI_ERROR_NONE  Successful
1487  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1488  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1489  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1490  */
1491 int wifi_ap_set_encryption_type(wifi_ap_h ap, wifi_encryption_type_e type) TIZEN_DEPRECATED_API;
1492
1493 /**
1494  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_is_passphrase_required() instead.
1495  * @brief Checks whether the passphrase is required or not.
1496  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1497  * @remarks This function is not valid if security type is #WIFI_SECURITY_TYPE_EAP.
1498  * @param[in] ap  The access point handle
1499  * @param[out] required  @c true if passphrase is required,
1500  *                       @c false if passphrase is not required.
1501  * @return 0 on success, otherwise negative error value
1502  * @retval #WIFI_ERROR_NONE  Successful
1503  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1504  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1505  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1506  */
1507 int wifi_ap_is_passphrase_required(wifi_ap_h ap, bool* required) TIZEN_DEPRECATED_API;
1508
1509 /**
1510  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_set_passphrase() instead.
1511  * @brief Sets the passphrase.
1512  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1513  * @param[in] ap  The access point handle
1514  * @param[in] passphrase  The passphrase of access point
1515  * @return 0 on success, otherwise negative error value
1516  * @retval #WIFI_ERROR_NONE  Successful
1517  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1518  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1519  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1520  */
1521 int wifi_ap_set_passphrase(wifi_ap_h ap, const char* passphrase) TIZEN_DEPRECATED_API;
1522
1523 /**
1524  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_is_wps_supported() instead.
1525  * @brief Checks whether the WPS(Wi-Fi Protected Setup) is supported or not.
1526  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1527  * @param[in] ap  The access point handle
1528  * @param[out] supported  @c ture if WPS is supported,
1529  *                        otherwise @c false is WPS is not supported.
1530  * @return 0 on success, otherwise negative error value
1531  * @retval #WIFI_ERROR_NONE  Successful
1532  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1533  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1534  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1535  * @see wifi_connect_by_wps_pbc()
1536  * @see wifi_connect_by_wps_pin()
1537  */
1538 int wifi_ap_is_wps_supported(wifi_ap_h ap, bool* supported) TIZEN_DEPRECATED_API;
1539
1540 /**
1541 * @}
1542 */
1543
1544
1545 /**
1546 * @addtogroup CAPI_NETWORK_WIFI_AP_SECURITY_EAP_MODULE
1547 * @{
1548 */
1549
1550 /**
1551  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_set_eap_passphrase() instead.
1552  * @brief Sets the passphrase of EAP.
1553  * @details You can set one of @a user_name and @a password as @c NULL.
1554  * In this case, the value of a parameter which is set as @c NULL will be the previous value.
1555  * But it is not allowed that both @a user_name and @a password are set as @c NULL.
1556  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1557  * @remarks This function is valid only if the EAP type is #WIFI_EAP_TYPE_PEAP or #WIFI_EAP_TYPE_TTLS.
1558  * @param[in] ap  The access point handle
1559  * @param[in] user_name  The user name \n
1560  *                       This value can be @c NULL.
1561  * @param[in] password  The password \n
1562  *                      This value can be @c NULL.
1563  * @return 0 on success, otherwise negative error value
1564  * @retval #WIFI_ERROR_NONE  Successful
1565  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1566  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
1567  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1568  */
1569 int wifi_ap_set_eap_passphrase(wifi_ap_h ap, const char* user_name, const char* password) TIZEN_DEPRECATED_API;
1570
1571 /**
1572  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_eap_passphrase() instead.
1573  * @brief Gets the passphrase of EAP.
1574  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1575  * @remarks This function is valid only if the EAP type is #WIFI_EAP_TYPE_PEAP or #WIFI_EAP_TYPE_TTLS.
1576  *          You must release @a user_name using free().
1577  * @param[in] ap  The access point handle
1578  * @param[out] user_name  The user name
1579  * @param[out] is_password_set  @c ture if password is set,
1580  *                              otherwise @c flase if password is not set.
1581  * @return 0 on success, otherwise negative error value
1582  * @retval #WIFI_ERROR_NONE  Successful
1583  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1584  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
1585  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
1586  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1587  */
1588 int wifi_ap_get_eap_passphrase(wifi_ap_h ap, char** user_name, bool* is_password_set) TIZEN_DEPRECATED_API;
1589
1590 /**
1591  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_eap_ca_cert_file() instead.
1592  * @brief Gets the CA Certificate of EAP.
1593  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1594  * @remarks This function is valid only if the EAP type is #WIFI_EAP_TYPE_TLS.
1595  *          You must release @a file using free().
1596  * @param[in] ap  The access point handle
1597  * @param[out] file  The file path of CA Certificate
1598  * @return 0 on success, otherwise negative error value
1599  * @retval #WIFI_ERROR_NONE  Successful
1600  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1601  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
1602  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
1603  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1604  */
1605 int wifi_ap_get_eap_ca_cert_file(wifi_ap_h ap, char** file) TIZEN_DEPRECATED_API;
1606
1607 /**
1608  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_set_eap_ca_cert_file() instead.
1609  * @brief Sets the CA Certificate of EAP.
1610  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1611  * @remarks This function is valid only if the EAP type is #WIFI_EAP_TYPE_TLS.
1612  * @param[in] ap  The access point handle
1613  * @param[in] file  The file path of CA Certificate
1614  * @return 0 on success, otherwise negative error value
1615  * @retval #WIFI_ERROR_NONE  Successful
1616  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1617  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
1618  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1619  */
1620 int wifi_ap_set_eap_ca_cert_file(wifi_ap_h ap, const char* file) TIZEN_DEPRECATED_API;
1621
1622 /**
1623  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_eap_client_cert_file() instead.
1624  * @brief Gets the Client Certificate of EAP.
1625  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1626  * @remarks This function is valid only if the EAP type is #WIFI_EAP_TYPE_TLS.
1627  *          You must release @a file using free().
1628  * @param[in] ap  The access point handle
1629  * @param[out] file  The file path of Client Certificate
1630  * @return 0 on success, otherwise negative error value
1631  * @retval #WIFI_ERROR_NONE  Successful
1632  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1633  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
1634  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
1635  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1636  */
1637 int wifi_ap_get_eap_client_cert_file(wifi_ap_h ap, char** file) TIZEN_DEPRECATED_API;
1638
1639 /**
1640  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_set_eap_client_cert_file() instead.
1641  * @brief Sets the CA Certificate of EAP.
1642  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1643  * @remarks This function is valid only if the EAP type is #WIFI_EAP_TYPE_TLS.
1644  * @param[in] ap  The access point handle
1645  * @param[in] file  The file path of Client Certificate
1646  * @return 0 on success, otherwise negative error value
1647  * @retval #WIFI_ERROR_NONE  Successful
1648  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1649  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
1650  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1651  */
1652 int wifi_ap_set_eap_client_cert_file(wifi_ap_h ap, const char* file) TIZEN_DEPRECATED_API;
1653
1654 /**
1655  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_eap_private_key_file() instead.
1656  * @brief Gets the private key file of EAP.
1657  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1658  * @remarks This function is valid only if the EAP type is #WIFI_EAP_TYPE_TLS.
1659  *          You must release @a file using free().
1660  * @param[in] ap  The access point handle
1661  * @param[out] file  The file path of private key
1662  * @return 0 on success, otherwise negative error value
1663  * @retval #WIFI_ERROR_NONE  Successful
1664  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1665  * @retval #WIFI_ERROR_OUT_OF_MEMORY  Out of memory
1666  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
1667  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1668  */
1669 int wifi_ap_get_eap_private_key_file(wifi_ap_h ap, char** file) TIZEN_DEPRECATED_API;
1670
1671 /**
1672  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_set_eap_private_key_info() instead.
1673  * @brief Sets the private key information of EAP.
1674  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1675  * @remarks This function is valid only if the EAP type is #WIFI_EAP_TYPE_TLS.
1676  * @param[in] ap  The access point handle
1677  * @param[in] file  The file path of private key
1678  * @param[in] password  The password
1679  * @return 0 on success, otherwise negative error value
1680  * @retval #WIFI_ERROR_NONE  Successful
1681  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1682  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
1683  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1684  */
1685 int wifi_ap_set_eap_private_key_info(wifi_ap_h ap, const char* file, const char* password) TIZEN_DEPRECATED_API;
1686
1687 /**
1688  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_eap_type() instead.
1689  * @brief Gets the EAP type of Wi-Fi.
1690  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1691  * @param[in] ap  The access point handle
1692  * @param[out] type  The type of EAP
1693  * @return 0 on success, otherwise negative error value
1694  * @retval #WIFI_ERROR_NONE  Successful
1695  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1696  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
1697  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1698  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1699  */
1700 int wifi_ap_get_eap_type(wifi_ap_h ap, wifi_eap_type_e* type) TIZEN_DEPRECATED_API;
1701
1702 /**
1703  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_set_eap_type() instead.
1704  * @brief Sets the EAP type of Wi-Fi.
1705  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1706  * @param[in] ap  The access point handle
1707  * @param[in] type  The type of EAP
1708  * @return 0 on success, otherwise negative error value
1709  * @retval #WIFI_ERROR_NONE  Successful
1710  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1711  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
1712  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1713  */
1714 int wifi_ap_set_eap_type(wifi_ap_h ap, wifi_eap_type_e type) TIZEN_DEPRECATED_API;
1715
1716 /**
1717  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_get_eap_auth_type() instead.
1718  * @brief Gets the type of EAP phase2 authentication of Wi-Fi.
1719  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1720  * @param[in] ap  The access point handle
1721  * @param[out] type  The type of EAP phase2 authentication
1722  * @return 0 on success, otherwise negative error value
1723  * @retval #WIFI_ERROR_NONE  Successful
1724  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1725  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
1726  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
1727  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1728  */
1729 int wifi_ap_get_eap_auth_type(wifi_ap_h ap, wifi_eap_auth_type_e* type) TIZEN_DEPRECATED_API;
1730
1731 /**
1732  * @deprecated Deprecated since 3.0. Use wifi_manager_ap_set_eap_auth_type() instead.
1733  * @brief Sets the type of EAP phase2 authentication of Wi-Fi.
1734  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
1735  * @param[in] ap  The access point handle
1736  * @param[in] type  The type of EAP phase2 authentication
1737  * @return 0 on success, otherwise negative error value
1738  * @retval #WIFI_ERROR_NONE  Successful
1739  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
1740  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
1741  * @retval #WIFI_ERROR_NOT_SUPPORTED   Not supported
1742  */
1743 int wifi_ap_set_eap_auth_type(wifi_ap_h ap, wifi_eap_auth_type_e type) TIZEN_DEPRECATED_API;
1744
1745 /**
1746 * @}
1747 */
1748
1749 /**
1750 * @addtogroup CAPI_NETWORK_WIFI_CONFIG_MODULE
1751 * @{
1752 */
1753
1754 /**
1755  * @deprecated Deprecated since 3.0. Use wifi_manager_config_create() instead.
1756  * @brief Gets access point configuration handle.
1757  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1758  * @remarks You must release @a config using wifi_config_destroy().
1759  *
1760  * @param[in] name                              The access point name
1761  * @param[in] passphrase                The access point passphrase
1762  * @param[in] security_type             The access point security type
1763  * @param[out] config                   The access point configuration handle
1764  *
1765  * @return 0 on success, otherwise negative error value
1766  * @retval #WIFI_ERROR_NONE                                     Successful
1767  * @retval #WIFI_ERROR_INVALID_OPERATION        Invalid operation
1768  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
1769  * @retval #WIFI_ERROR_OUT_OF_MEMORY            Out of memory
1770  * @retval #WIFI_ERROR_NOT_SUPPORTED            Not supported
1771  * @see wifi_config_destroy()
1772  * @pre This API needs wifi_initialize() before use
1773  */
1774 int wifi_config_create(const char *name, const char *passphrase, wifi_security_type_e security_type, wifi_config_h *config) TIZEN_DEPRECATED_API;
1775
1776 /**
1777  * @deprecated Deprecated since 3.0. Use wifi_manager_config_clone() instead.
1778  * @brief Clones the access point configuration handle.
1779  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1780  * @remarks You must release @a cloned_config using wifi_config_destroy().
1781  *
1782  * @param[in] origin                            The origin access point configuration handle
1783  * @param[out] cloned_config    The cloned access point configuration handle
1784  *
1785  * @return 0 on success, otherwise negative error value
1786  * @retval #WIFI_ERROR_NONE                                     Successful
1787  * @retval #WIFI_ERROR_INVALID_OPERATION        Invalid operation
1788  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
1789  * @retval #WIFI_ERROR_OUT_OF_MEMORY            Out of memory
1790  * @retval #WIFI_ERROR_NOT_SUPPORTED            Not supported
1791  * @see wifi_config_destroy()
1792  */
1793 int wifi_config_clone(wifi_config_h origin, wifi_config_h *cloned_config) TIZEN_DEPRECATED_API;
1794
1795 /**
1796  * @deprecated Deprecated since 3.0. Use wifi_manager_config_destroy() instead.
1797  * @brief Destroys the access point configuration handle.
1798  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1799  *
1800  * @param[in] config    The access point configuration handle
1801  *
1802  * @return 0 on success, otherwise negative error value
1803  * @retval #WIFI_ERROR_NONE                                     Successful
1804  * @retval #WIFI_ERROR_INVALID_OPERATION        Invalid operation
1805  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
1806  * @retval #WIFI_ERROR_NOT_SUPPORTED            Not supported
1807  * @see wifi_config_create()
1808  * @see wifi_config_clone()
1809  */
1810 int wifi_config_destroy(wifi_config_h config) TIZEN_DEPRECATED_API;
1811
1812 /**
1813  * @deprecated Deprecated since 3.0. Use wifi_manager_config_save() instead.
1814  * @brief Saves Wi-Fi configuration of access point.
1815  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1816  * @privlevel public
1817  * @privilege %http://tizen.org/privilege/network.profile
1818  *
1819  * @param[in] config    The access point configuration handle
1820  *
1821  * @return 0 on success, otherwise negative error value
1822  * @retval #WIFI_ERROR_NONE                                     Successful
1823  * @retval #WIFI_ERROR_INVALID_OPERATION        Invalid operation
1824  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
1825  * @retval #WIFI_ERROR_PERMISSION_DENIED        Permission denied
1826  * @retval #WIFI_ERROR_NOT_SUPPORTED            Not supported
1827  * @see wifi_config_create()
1828  */
1829 int wifi_config_save_configuration(wifi_config_h config) TIZEN_DEPRECATED_API;
1830
1831 /**
1832  * @deprecated Deprecated since 3.0. Use wifi_manager_config_remove() instead.
1833  * @brief Removes Wi-Fi configuration of access point.
1834  * @since_tizen 3.0
1835  * @privlevel public
1836  * @privilege %http://tizen.org/privilege/network.profile
1837  *
1838  * @param[in] config    The access point configuration handle
1839  *
1840  * @return 0 on success, otherwise negative error value
1841  * @retval #WIFI_ERROR_NONE                                     Successful
1842  * @retval #WIFI_ERROR_INVALID_OPERATION        Invalid operation
1843  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
1844  * @retval #WIFI_ERROR_PERMISSION_DENIED        Permission denied
1845  * @retval #WIFI_ERROR_NOT_SUPPORTED            Not supported
1846  * @see wifi_config_create()
1847  * @see wifi_config_foreach_configuration()
1848  */
1849 int wifi_config_remove(wifi_config_h config) TIZEN_DEPRECATED_API;
1850
1851 /**
1852  * @deprecated Deprecated since 3.0. Use wifi_manager_config_foreach_configuration() instead.
1853  * @brief Gets the result of access point configurations repeatedly.
1854  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1855  * @privlevel public
1856  * @privilege %http://tizen.org/privilege/network.profile
1857  *
1858  * @param[in] callback          The callback to be called
1859  * @param[in] user_data         The user data passed to the callback function
1860  *
1861  * @return 0 on success, otherwise negative error value
1862  * @retval #WIFI_ERROR_NONE                                     Successful
1863  * @retval #WIFI_ERROR_INVALID_OPERATION        Invalid operation
1864  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
1865  * @retval #WIFI_ERROR_PERMISSION_DENIED        Permission denied
1866  * @retval #WIFI_ERROR_OUT_OF_MEMORY            Out of memory
1867  * @retval #WIFI_ERROR_NOT_SUPPORTED            Not supported
1868  * @pre This API needs wifi_initialize() before use.
1869  * @post This function invokes wifi_config_list_cb().
1870  */
1871 int wifi_config_foreach_configuration(wifi_config_list_cb callback, void *user_data) TIZEN_DEPRECATED_API;
1872
1873 /**
1874  * @deprecated Deprecated since 3.0. Use wifi_manager_config_get_name() instead.
1875  * @brief Gets the name of access point from configuration.
1876  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1877  * @remarks You must release @a name using free().
1878  *
1879  * @param[in] config    The access point configuration handle
1880  * @param[out] name             The name of access point
1881  *
1882  * @return 0 on success, otherwise negative error value
1883  * @retval #WIFI_ERROR_NONE                                     Successful
1884  * @retval #WIFI_ERROR_INVALID_OPERATION        Invalid operation
1885  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
1886  * @retval #WIFI_ERROR_OUT_OF_MEMORY            Out of memory
1887  * @retval #WIFI_ERROR_NOT_SUPPORTED            Not supported
1888  */
1889 int wifi_config_get_name(wifi_config_h config, char **name) TIZEN_DEPRECATED_API;
1890
1891 /**
1892  * @deprecated Deprecated since 3.0. Use wifi_manager_config_get_security_type() instead.
1893  * @brief Gets the security type of access point from configuration.
1894  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1895  *
1896  * @param[in] config                    The access point configuration handle
1897  * @param[out] security_type    The security type of access point
1898  *
1899  * @return 0 on success, otherwise negative error value
1900  * @retval #WIFI_ERROR_NONE                                     Successful
1901  * @retval #WIFI_ERROR_INVALID_OPERATION        Invalid operation
1902  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
1903  * @retval #WIFI_ERROR_NOT_SUPPORTED            Not supported
1904  */
1905 int wifi_config_get_security_type(wifi_config_h config, wifi_security_type_e *security_type) TIZEN_DEPRECATED_API;
1906
1907 /**
1908  * @deprecated Deprecated since 3.0. Use wifi_manager_config_set_proxy_address() instead.
1909  * @brief Sets access point proxy address configuration.
1910  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1911  * @privlevel public
1912  * @privilege %http://tizen.org/privilege/network.profile
1913  *
1914  * @param[in] config                    The access point configuration handle
1915  * @param[in] address_family    The address family
1916  * @param[in] proxy_address             The proxy address
1917  *
1918  * @return 0 on success, otherwise negative error value
1919  * @retval #WIFI_ERROR_NONE                                     Successful
1920  * @retval #WIFI_ERROR_INVALID_OPERATION        Invalid operation
1921  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
1922  * @retval #WIFI_ERROR_PERMISSION_DENIED        Permission denied
1923  * @retval #WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED Not supported address family
1924  * @retval #WIFI_ERROR_NOT_SUPPORTED            Not supported
1925  */
1926 int wifi_config_set_proxy_address(wifi_config_h config, wifi_address_family_e address_family, const char *proxy_address) TIZEN_DEPRECATED_API;
1927
1928 /**
1929  * @deprecated Deprecated since 3.0. Use wifi_manager_config_get_proxy_address() instead.
1930  * @brief Gets the proxy address of access point from configuration.
1931  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1932  * @remarks You must release @a proxy_address using free().
1933  *
1934  * @param[in] config                    The access point configuration handle
1935  * @param[out] address_family   The address family
1936  * @param[out] proxy_address    The proxy address
1937  *
1938  * @return 0 on success, otherwise negative error value
1939  * @retval #WIFI_ERROR_NONE                                     Successful
1940  * @retval #WIFI_ERROR_INVALID_OPERATION        Invalid operation
1941  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
1942  * @retval #WIFI_ERROR_OUT_OF_MEMORY            Out of memory
1943  * @retval #WIFI_ERROR_NOT_SUPPORTED            Not supported
1944  */
1945 int wifi_config_get_proxy_address(wifi_config_h config, wifi_address_family_e *address_family, char **proxy_address) TIZEN_DEPRECATED_API;
1946
1947 /**
1948  * @deprecated Deprecated since 3.0. Use wifi_manager_config_set_hidden_ap_property() instead.
1949  * @brief Sets the hidden property of access point from the configuration.
1950  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1951  * @privlevel public
1952  * @privilege %http://tizen.org/privilege/network.profile
1953  *
1954  * @param[in] config            The access point configuration handle
1955  * @param[in] is_hidden         true to enable and false to disable
1956  *
1957  * @return 0 on success, otherwise negative error value
1958  * @retval #WIFI_ERROR_NONE                                     Successful
1959  * @retval #WIFI_ERROR_INVALID_OPERATION        Invalid operation
1960  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
1961  * @retval #WIFI_ERROR_PERMISSION_DENIED        Permission denied
1962  * @retval #WIFI_ERROR_NOT_SUPPORTED            Not supported
1963  */
1964 int wifi_config_set_hidden_ap_property(wifi_config_h config, bool is_hidden) TIZEN_DEPRECATED_API;
1965
1966 /**
1967  * @deprecated Deprecated since 3.0. Use wifi_manager_config_get_hidden_ap_property() instead.
1968  * @brief Gets the hidden property of access point from the configuration.
1969  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1970  *
1971  * @param[in] config            The access point configuration handle
1972  * @param[out] is_hidden        The hidden property of access point
1973  *
1974  * @return 0 on success, otherwise negative error value
1975  * @retval #WIFI_ERROR_NONE                                     Successful
1976  * @retval #WIFI_ERROR_INVALID_OPERATION        Invalid operation
1977  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
1978  * @retval #WIFI_ERROR_NOT_SUPPORTED            Not supported
1979  */
1980 int wifi_config_get_hidden_ap_property(wifi_config_h config, bool *is_hidden) TIZEN_DEPRECATED_API;
1981
1982 /**
1983  * @deprecated Deprecated since 3.0. Use wifi_manager_config_get_eap_anonymous_identity() instead.
1984  * @brief Gets access point anonymous identity from configuration.
1985  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
1986  * @remarks You must release @a anonymous_identity using free().
1987  *
1988  * @param[in] config                            The access point configuration handle
1989  * @param[out] anonymous_identity       The anonymous identity of access point
1990  *
1991  * @return 0 on success, otherwise negative error value
1992  * @retval #WIFI_ERROR_NONE                                     Successful
1993  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
1994  */
1995 int wifi_config_get_eap_anonymous_identity(wifi_config_h config, char** anonymous_identity) TIZEN_DEPRECATED_API;
1996
1997 /**
1998  * @deprecated Deprecated since 3.0. Use wifi_manager_config_set_eap_anonymous_identity() instead.
1999  * @brief Sets access point anonymous identity to configuration.
2000  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
2001  * @privlevel public
2002  * @privilege %http://tizen.org/privilege/network.profile
2003  *
2004  * @param[in] config                            The access point configuration handle
2005  * @param[in] anonymous_identity        The anonymous identity
2006  *
2007  * @return 0 on success, otherwise negative error value
2008  * @retval #WIFI_ERROR_NONE                                     Successful
2009  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
2010  * @retval #WIFI_ERROR_PERMISSION_DENIED        Permission Denied
2011  */
2012 int wifi_config_set_eap_anonymous_identity(wifi_config_h config, const char* anonymous_identity) TIZEN_DEPRECATED_API;
2013
2014 /**
2015  * @deprecated Deprecated since 3.0. Use wifi_manager_config_get_eap_ca_cert_file() instead.
2016  * @brief Gets access point cacert file from configuration.
2017  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
2018  * @remarks You must release @a ca_cert using free().
2019  * @remarks The mediastorage privilege http://tizen.org/privilege/mediastorage is needed \n
2020  *                       if @a image_path is relevant to media storage.\n
2021  *                       The externalstorage privilege http://tizen.org/privilege/externalstorage is needed \n
2022  *                       if @a image_path is relevant to external storage.
2023  *
2024  * @param[in] config            The access point configuration handle
2025  * @param[out] ca_cert          The certification authority(CA) certificates file of access point
2026  *
2027  * @return 0 on success, otherwise negative error value
2028  * @retval #WIFI_ERROR_NONE                                     Successful
2029  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
2030  */
2031 int wifi_config_get_eap_ca_cert_file(wifi_config_h config, char** ca_cert) TIZEN_DEPRECATED_API;
2032
2033 /**
2034  * @deprecated Deprecated since 3.0. Use wifi_manager_config_set_eap_ca_cert_file() instead.
2035  * @brief Sets access point cacert file to configuration.
2036  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
2037  * @privlevel public
2038  * @privilege %http://tizen.org/privilege/network.profile
2039  * @remarks The mediastorage privilege http://tizen.org/privilege/mediastorage is needed \n
2040  *                       if @a image_path is relevant to media storage.\n
2041  *                       The externalstorage privilege http://tizen.org/privilege/externalstorage is needed \n
2042  *                       if @a image_path is relevant to external storage.
2043  *
2044  * @param[in] config            The access point configuration handle
2045  * @param[in] ca_cert           The certification authority(CA) certificates file of access point
2046  *
2047  * @return 0 on success, otherwise negative error value
2048  * @retval #WIFI_ERROR_NONE                                     Successful
2049  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
2050  * @retval #WIFI_ERROR_PERMISSION_DENIED        Permission Denied
2051  */
2052 int wifi_config_set_eap_ca_cert_file(wifi_config_h config, const char* ca_cert) TIZEN_DEPRECATED_API;
2053
2054 /**
2055  * @deprecated Deprecated since 3.0. Use wifi_manager_config_get_eap_client_cert_file() instead.
2056  * @brief Gets access point client cert file from configuration.
2057  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
2058  * @remarks You must release @a client_crt using free().
2059  *
2060  * @param[in] config            The access point configuration handle
2061  * @param[out] client_cert      The certification authority(CA) certificates file of access point
2062  *
2063  * @return 0 on success, otherwise negative error value
2064  * @retval #WIFI_ERROR_NONE                                     Successful
2065  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
2066  */
2067 int wifi_config_get_eap_client_cert_file(wifi_config_h config, char** client_cert) TIZEN_DEPRECATED_API;
2068
2069 /**
2070  * @deprecated Deprecated since 3.0. Use wifi_manager_config_set_eap_client_cert_file() instead.
2071  * @brief Sets access point client cert file to configuration.
2072  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
2073  * @privlevel public
2074  * @privilege %http://tizen.org/privilege/network.profile
2075  *
2076  * @param[in] config            The access point configuration handle
2077  * @param[in] private_key       The private key file
2078  * @param[in] client_cert               The certification authority(CA) certificates file of access point
2079  *
2080  * @return 0 on success, otherwise negative error value
2081  * @retval #WIFI_ERROR_NONE                                     Successful
2082  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
2083  * @retval #WIFI_ERROR_PERMISSION_DENIED        Permission Denied
2084  */
2085 int wifi_config_set_eap_client_cert_file(wifi_config_h config, const char* private_key, const char* client_cert) TIZEN_DEPRECATED_API;
2086
2087 /**
2088  * @deprecated Deprecated since 3.0. Use wifi_manager_config_get_eap_identity() instead.
2089  * @brief Gets access point identity from configuration.
2090  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
2091  * @remarks You must release @a identity using free().
2092  *
2093  * @param[in] config            The access point configuration handle
2094  * @param[out] identity         The identity of access point
2095  *
2096  * @return 0 on success, otherwise negative error value
2097  * @retval #WIFI_ERROR_NONE                                     Successful
2098  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
2099  */
2100 int wifi_config_get_eap_identity(wifi_config_h config, char** identity) TIZEN_DEPRECATED_API;
2101
2102 /**
2103  * @deprecated Deprecated since 3.0. Use wifi_manager_config_set_eap_identity() instead.
2104  * @brief Sets access point identity to configuration.
2105  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
2106  * @privlevel public
2107  * @privilege %http://tizen.org/privilege/network.profile
2108  *
2109  * @param[in] config            The access point configuration handle
2110  * @param[in] identity          The identity
2111  *
2112  * @return 0 on success, otherwise negative error value
2113  * @retval #WIFI_ERROR_NONE                                     Successful
2114  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
2115  * @retval #WIFI_ERROR_PERMISSION_DENIED        Permission Denied
2116  */
2117 int wifi_config_set_eap_identity(wifi_config_h config, const char* identity) TIZEN_DEPRECATED_API;
2118
2119 /**
2120  * @deprecated Deprecated since 3.0. Use wifi_manager_config_get_eap_type() instead.
2121  * @brief Gets access point eap type from configuration.
2122  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
2123  *
2124  * @param[in] config            The access point configuration handle
2125  * @param[out] eap_type The eap type of access point
2126  *
2127  * @return 0 on success, otherwise negative error value
2128  * @retval #WIFI_ERROR_NONE                                     Successful
2129  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
2130  */
2131 int wifi_config_get_eap_type(wifi_config_h config, wifi_eap_type_e *eap_type) TIZEN_DEPRECATED_API;
2132
2133 /**
2134  * @deprecated Deprecated since 3.0. Use wifi_manager_config_set_eap_type() instead.
2135  * @brief Sets access point eap type to configuration.
2136  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
2137  * @privlevel public
2138  * @privilege %http://tizen.org/privilege/network.profile
2139  *
2140  * @param[in] config            The access point configuration handle
2141  * @param[in] eap_type          The eap type
2142  *
2143  * @return 0 on success, otherwise negative error value
2144  * @retval #WIFI_ERROR_NONE                                     Successful
2145  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
2146  * @retval #WIFI_ERROR_PERMISSION_DENIED        Permission Denied
2147  */
2148 int wifi_config_set_eap_type(wifi_config_h config, wifi_eap_type_e eap_type) TIZEN_DEPRECATED_API;
2149
2150 /**
2151  * @deprecated Deprecated since 3.0. Use wifi_manager_config_get_eap_auth_type() instead.
2152  * @brief Gets access point eap auth type from configuration.
2153  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
2154  *
2155  * @param[in] config                    The access point configuration handle
2156  * @param[out] eap_auth_type    The eap auth type of access point
2157  *
2158  * @return 0 on success, otherwise negative error value
2159  * @retval #WIFI_ERROR_NONE                                     Successful
2160  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
2161  */
2162 int wifi_config_get_eap_auth_type(wifi_config_h config, wifi_eap_auth_type_e* eap_auth_type) TIZEN_DEPRECATED_API;
2163
2164 /**
2165  * @deprecated Deprecated since 3.0. Use wifi_manager_config_set_eap_auth_type() instead.
2166  * @brief Sets access point eap auth type to configuration.
2167  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
2168  * @privlevel public
2169  * @privilege %http://tizen.org/privilege/network.profile
2170  *
2171  * @param[in] config                    The access point configuration handle
2172  * @param[in] eap_auth_type     The eap auth type
2173  *
2174  * @return 0 on success, otherwise negative error value
2175  * @retval #WIFI_ERROR_NONE                                     Successful
2176  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
2177  * @retval #WIFI_ERROR_PERMISSION_DENIED        Permission Denied
2178  */
2179 int wifi_config_set_eap_auth_type(wifi_config_h config, wifi_eap_auth_type_e eap_auth_type) TIZEN_DEPRECATED_API;
2180
2181 /**
2182  * @deprecated Deprecated since 3.0. Use wifi_manager_config_get_eap_subject_match() instead.
2183  * @brief Gets access point subject match from configuration.
2184  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
2185  * @remarks You must release @a subject_match using free().
2186  *
2187  * @param[in] config                    The access point configuration handle
2188  * @param[out] subject_match    The subject match of access point
2189  *
2190  * @return 0 on success, otherwise negative error value
2191  * @retval #WIFI_ERROR_NONE                                     Successful
2192  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
2193  */
2194 int wifi_config_get_eap_subject_match(wifi_config_h config, char** subject_match) TIZEN_DEPRECATED_API;
2195
2196 /**
2197  * @deprecated Deprecated since 3.0. Use wifi_manager_config_set_eap_subject_match() instead.
2198  * @brief Sets access point subject match to configuration.
2199  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
2200  * @privlevel public
2201  * @privilege %http://tizen.org/privilege/network.profile
2202  *
2203  * @param[in] config                    The access point configuration handle
2204  * @param[in] subject_match     The subject match
2205  *
2206  * @return 0 on success, otherwise negative error value
2207  * @retval #WIFI_ERROR_NONE                                     Successful
2208  * @retval #WIFI_ERROR_INVALID_PARAMETER        Invalid parameter
2209  * @retval #WIFI_ERROR_PERMISSION_DENIED        Permission Denied
2210  */
2211 int wifi_config_set_eap_subject_match(wifi_config_h config, const char* subject_match) TIZEN_DEPRECATED_API;
2212
2213 /**
2214  * @}
2215  */
2216
2217 /**
2218  * @addtogroup CAPI_NETWORK_WIFI_TDLS_MODULE
2219  * @{
2220  */
2221
2222 /**
2223  * @deprecated Deprecated since 3.0. Use wifi_manager_tdls_state_e instead.
2224  * @brief Enumeration for the state of the Wi-Fi TDLS.
2225  * @since_tizen 3.0
2226  */
2227 typedef enum
2228 {
2229         WIFI_TDLS_STATE_DISCONNECTED = 0,  /**< Wi-Fi TDLS is Disconnected */
2230         WIFI_TDLS_STATE_CONNECTED = 1,     /**< Wi-Fi TDLS is Connected */
2231 } wifi_tdls_state_e;
2232
2233 /**
2234  * @deprecated Deprecated since 3.0. Use wifi_manager_tdls_state_changed_cb instead.
2235  * @brief Called when the WiFi TDLS state is changed.
2236  * @since_tizen 3.0
2237  *
2238  * @param[in] state  The TDLS state
2239  * @param[in] peer_mac_addr  MAC address of the TDLS peer
2240  * @param[in] user_data  The user data passed from the callback registration function
2241  * @see wifi_tdls_set_state_changed_cb()
2242  * @see wifi_tdls_unset_state_changed_cb()
2243  */
2244 typedef void(*wifi_tdls_state_changed_cb)(wifi_tdls_state_e state, char* peer_mac_addr, void* user_data);
2245
2246 /**
2247  * @deprecated Deprecated since 3.0. Use wifi_manager_tdls_disconnect() instead.
2248  * @brief Disconnects the connected peer.
2249  * @since_tizen 3.0
2250  * @privlevel public
2251  * @privilege %http://tizen.org/privilege/network.set
2252  *
2253  * @param[in] peer_mac_addr  The MAC address of the connected peer
2254  *
2255  * @return @c 0 on success, otherwise negative error value
2256  * @retval #WIFI_ERROR_NONE  Successful
2257  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
2258  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
2259  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
2260  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
2261  * @retval #WIFI_ERROR_NOT_SUPPORTED     Not supported
2262  */
2263 int wifi_tdls_disconnect(const char* peer_mac_addr) TIZEN_DEPRECATED_API;
2264
2265 /**
2266  * @deprecated Deprecated since 3.0. Use wifi_manager_tdls_get_connected_peer() instead.
2267  * @brief Gets Peer Mac address of Connected peer.
2268  * @since_tizen 3.0
2269  * @privlevel public
2270  * @privilege %http://tizen.org/privilege/network.get
2271  *
2272  * @remarks The @a peer_mac_addr should be freed using free().
2273  * @param[out] peer_mac_addr  The MAC address of the connected peer
2274  *
2275  * @return @c 0 on success, otherwise negative error value
2276  * @retval #WIFI_ERROR_NONE  Successful
2277  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
2278  * @retval #WIFI_ERROR_INVALID_PARAMETER  Invalid parameter
2279  * @retval #WIFI_ERROR_OPERATION_FAILED  Operation failed
2280  * @retval #WIFI_ERROR_NO_CONNECTION     No active TDLS Connection
2281  * @retval #WIFI_ERROR_PERMISSION_DENIED Permission Denied
2282  * @retval #WIFI_ERROR_NOT_SUPPORTED     Not supported
2283  */
2284 int wifi_tdls_get_connected_peer(char** peer_mac_addr) TIZEN_DEPRECATED_API;
2285
2286 /**
2287  * @deprecated Deprecated since 3.0. Use wifi_manager_tdls_set_state_changed_cb() instead.
2288  * @brief Registers the callback called when TDLS state is changed.
2289  * @since_tizen 3.0
2290  *
2291  * @param[in] callback  The callback function to be called
2292  * @param[in] user_data The user data passed to the callback function
2293  *
2294  * @return @c 0 on success, otherwise negative error value
2295  * @retval #WIFI_ERROR_NONE  Successful
2296  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
2297  * @retval #WIFI_ERROR_INVALID_PARAMETER   Invalid parameter
2298  * @retval #WIFI_ERROR_NOT_SUPPORTED     Not supported
2299  */
2300 int wifi_tdls_set_state_changed_cb(wifi_tdls_state_changed_cb callback, void* user_data) TIZEN_DEPRECATED_API;
2301
2302 /**
2303  * @deprecated Deprecated since 3.0. Use wifi_manager_tdls_unset_state_changed_cb() instead.
2304  * @brief Unregisters the callback called when TDLS state is changed.
2305  * @since_tizen 3.0
2306  *
2307  * @return @c 0 on success, otherwise negative error value
2308  * @retval #WIFI_ERROR_NONE  Successful
2309  * @retval #WIFI_ERROR_INVALID_OPERATION  Invalid operation
2310  * @retval #WIFI_ERROR_NOT_SUPPORTED     Not supported
2311  */
2312 int wifi_tdls_unset_state_changed_cb(void) TIZEN_DEPRECATED_API;
2313
2314 /**
2315  * @}
2316  */
2317
2318 #ifdef __cplusplus
2319 }
2320 #endif
2321
2322 #endif /* __TIZEN_NETWORK_WIFI_H__ */