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