Tizen Native API  4.0
Wi-Fi Management

The Wi-Fi API provides functions for managing Wi-Fi.

Required Header

#include <wifi-manager.h>

Overview

To use Wifi Manager API, first create a wifi handle using wifi_manager_initialize(). After that, you can obtain wifi information. You should destroy the created wifi handle if you do not need it anymore. The Wi-Fi Manager provides functions for managing Wi-Fi. Using the Wi-Fi Manager, you can implement features that allow the users of your application to:

  • Activate / Deactivate the Wi-Fi device
  • Connect to the access point
  • Scans the access points

Related Features

This API is related with the following features:

It is recommended to design applications with regard to features, for reliability.

You can check if a device supports the related features for this API by using System Information, and control your application's actions accordingly.

To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.

More details on featuring your application can be found from Feature Element.

Functions

int wifi_manager_activate (wifi_manager_h wifi, wifi_manager_activated_cb callback, void *user_data)
 Activates Wi-Fi asynchronously.
int wifi_manager_activate_with_wifi_picker_tested (wifi_manager_h wifi, wifi_manager_activated_cb callback, void *user_data)
 Activates Wi-Fi asynchronously and displays Wi-Fi picker (popup) when Wi-Fi is not automatically connected.
int wifi_manager_deactivate (wifi_manager_h wifi, wifi_manager_deactivated_cb callback, void *user_data)
 Deactivates Wi-Fi asynchronously.
int wifi_manager_is_activated (wifi_manager_h wifi, bool *activated)
 Checks whether Wi-Fi is activated.
int wifi_manager_get_mac_address (wifi_manager_h wifi, char **mac_address)
 Gets the local MAC address.
int wifi_manager_get_network_interface_name (wifi_manager_h wifi, char **name)
 Gets the name of the network interface.
int wifi_manager_scan (wifi_manager_h wifi, wifi_manager_scan_finished_cb callback, void *user_data)
 Starts scan asynchronously.
int wifi_manager_get_scan_state (wifi_manager_h wifi, wifi_manager_scan_state_e *scan_state)
 Gets the Wi-Fi scan state.
int wifi_manager_scan_specific_ap (wifi_manager_h wifi, const char *essid, wifi_manager_scan_finished_cb callback, void *user_data)
 Starts specific AP scan, asynchronously.
int wifi_manager_specific_scan_create (wifi_manager_h wifi, wifi_manager_specific_scan_h *specific_scan)
 Creates a Wi-Fi specific AP scan handle.
int wifi_manager_specific_scan_destroy (wifi_manager_h wifi, wifi_manager_specific_scan_h specific_scan)
 Destroys a Wi-Fi specific AP scan handle.
int wifi_manager_specific_scan_set_ssid (wifi_manager_specific_scan_h specific_scan, const char *essid)
 Sets the SSID of a specific AP scan.
int wifi_manager_specific_scan_set_freq (wifi_manager_specific_scan_h specific_scan, int freq)
 Sets the channel frequency of a specific AP scan.
int wifi_manager_specific_ap_start_multi_scan (wifi_manager_h wifi, wifi_manager_specific_scan_h specific_scan, wifi_manager_scan_finished_cb callback, void *user_data)
 Starts multi SSID and multi channel specific scan, asynchronously.
int wifi_manager_connect_hidden_ap (wifi_manager_h wifi, const char *essid, wifi_manager_security_type_e sec_type, const char *passphrase, wifi_manager_connected_cb callback, void *user_data)
 Connects to the hidden AP, asynchronously.
int wifi_manager_get_connected_ap (wifi_manager_h wifi, wifi_manager_ap_h *ap)
 Gets the handle of the connected access point.
int wifi_manager_foreach_found_ap (wifi_manager_h wifi, wifi_manager_found_ap_cb callback, void *user_data)
 Gets the result of the scan.
int wifi_manager_foreach_found_specific_ap (wifi_manager_h wifi, wifi_manager_found_ap_cb callback, void *user_data)
 Gets the result of specific AP scan.
int wifi_manager_foreach_found_bssid_ap (wifi_manager_h wifi, wifi_manager_found_ap_cb callback, void *user_data)
 Gets the result of the BSSID scan (i.e. BSSID, ESSID & RSSI).
int wifi_manager_connect (wifi_manager_h wifi, wifi_manager_ap_h ap, wifi_manager_connected_cb callback, void *user_data)
 Connects to the access point asynchronously.
int wifi_manager_disconnect (wifi_manager_h wifi, wifi_manager_ap_h ap, wifi_manager_disconnected_cb callback, void *user_data)
 Disconnects to the access point asynchronously.
int wifi_manager_connect_by_wps_pbc (wifi_manager_h wifi, wifi_manager_ap_h ap, wifi_manager_connected_cb callback, void *user_data)
 Connects to the access point with WPS PBC asynchronously.
int wifi_manager_connect_by_wps_pin (wifi_manager_h wifi, wifi_manager_ap_h ap, const char *pin, wifi_manager_connected_cb callback, void *user_data)
 Connects to the access point with WPS PIN asynchronously.
int wifi_manager_connect_by_wps_pbc_without_ssid (wifi_manager_h wifi, wifi_manager_connected_cb callback, void *user_data)
 Connects to the access point with WPS PBC without entering SSID.
int wifi_manager_connect_by_wps_pin_without_ssid (wifi_manager_h wifi, const char *pin, wifi_manager_connected_cb callback, void *user_data)
 Connects to the access point with WPS PIN without entering SSID.
int wifi_manager_cancel_wps (wifi_manager_h wifi)
 Stops ongoing WPS provisioning / disconnects from the connected access point.
int wifi_manager_forget_ap (wifi_manager_h wifi, wifi_manager_ap_h ap)
 Deletes the information of a stored access point and disconnects from it if it was connected to.
int wifi_manager_update_ap (wifi_manager_h wifi, wifi_manager_ap_h ap)
 Updates an existing AP.

Typedefs

typedef void * wifi_manager_specific_scan_h
 The Wi-Fi specific ap scan handle.
typedef bool(* wifi_manager_found_ap_cb )(wifi_manager_ap_h ap, void *user_data)
 Called for each found access point.
typedef void(* wifi_manager_scan_finished_cb )(wifi_manager_error_e error_code, void *user_data)
 Called when the scan is finished.
typedef void(* wifi_manager_scan_state_changed_cb )(wifi_manager_scan_state_e state, void *user_data)
 Called when the scanning state is changed.
typedef void(* wifi_manager_activated_cb )(wifi_manager_error_e result, void *user_data)
 Called after wifi_manager_activate() or wifi_manager_activate_with_wifi_picker_tested() is completed.
typedef void(* wifi_manager_deactivated_cb )(wifi_manager_error_e result, void *user_data)
 Called after wifi_manager_deactivate() is completed.
typedef void(* wifi_manager_connected_cb )(wifi_manager_error_e result, void *user_data)
 Called when the connection process is completed.
typedef void(* wifi_manager_disconnected_cb )(wifi_manager_error_e result, void *user_data)
 Called after wifi_manager_disconnect() is completed.
typedef void(* wifi_manager_bssid_scan_finished_cb )(wifi_manager_error_e error_code, void *user_data)
 Called when the BSSID scan is finished.

Typedef Documentation

typedef void(* wifi_manager_activated_cb)(wifi_manager_error_e result, void *user_data)

Called after wifi_manager_activate() or wifi_manager_activate_with_wifi_picker_tested() is completed.

Since :
3.0
Parameters:
[in]resultThe result
[in]user_dataThe user data passed from wifi_manager_activate() and wifi_manager_activate_with_wifi_picker_tested()
Precondition:
wifi_manager_activate() or wifi_manager_activate_with_wifi_picker_tested() will invoke this callback function.
See also:
wifi_manager_activate()
wifi_manager_activate_with_wifi_picker_tested()
typedef void(* wifi_manager_bssid_scan_finished_cb)(wifi_manager_error_e error_code, void *user_data)

Called when the BSSID scan is finished.

Since :
4.0
Parameters:
[in]error_codeThe error code
[in]user_dataThe user data passed from the callback registration function
See also:
wifi_manager_scan()
wifi_manager_bssid_scan()
wifi_manager_set_background_scan_cb()
wifi_manager_unset_background_scan_cb()
typedef void(* wifi_manager_connected_cb)(wifi_manager_error_e result, void *user_data)

Called when the connection process is completed.

The following functions start the connection process and will result in the callback being called:

typedef void(* wifi_manager_deactivated_cb)(wifi_manager_error_e result, void *user_data)

Called after wifi_manager_deactivate() is completed.

Since :
3.0
Parameters:
[in]resultThe result
[in]user_dataThe user data passed from wifi_manager_deactivate()
Precondition:
wifi_manager_deactivate() will invoke this callback function.
See also:
wifi_manager_deactivate()
typedef void(* wifi_manager_disconnected_cb)(wifi_manager_error_e result, void *user_data)

Called after wifi_manager_disconnect() is completed.

Since :
3.0
Parameters:
[in]resultThe result
[in]user_dataThe user data passed from wifi_manager_disconnect()
Precondition:
wifi_manager_disconnect() will invoke this callback function.
See also:
wifi_manager_disconnect()
typedef bool(* wifi_manager_found_ap_cb)(wifi_manager_ap_h ap, void *user_data)

Called for each found access point.

Since :
3.0
Remarks:
AP is valid only in this function. In order to use AP outside this function, you must copy the AP with wifi_manager_ap_clone().
Parameters:
[in]apThe access point
[in]user_dataThe user data passed from the request function
Returns:
true to continue with the next iteration of the loop,
otherwise false to break out of the loop
Precondition:
wifi_manager_foreach_found_ap() will invoke this callback.
wifi_manager_foreach_found_specific_ap() will invoke this callback.
See also:
wifi_manager_foreach_found_ap()
wifi_manager_foreach_found_specific_ap()
typedef void(* wifi_manager_scan_finished_cb)(wifi_manager_error_e error_code, void *user_data)

Called when the scan is finished.

Since :
3.0
Parameters:
[in]error_codeThe error code
[in]user_dataThe user data passed from the callback registration function
See also:
wifi_manager_scan()
wifi_manager_set_background_scan_cb()
wifi_manager_unset_background_scan_cb()
typedef void(* wifi_manager_scan_state_changed_cb)(wifi_manager_scan_state_e state, void *user_data)

Called when the scanning state is changed.

Since :
4.0
Parameters:
[in]stateThe wifi scanning state
[in]user_dataThe user data passed from the callback registration function
See also:
wifi_manager_set_scan_state_changed_cb()
wifi_manager_unset_scan_state_changed_cb()

The Wi-Fi specific ap scan handle.

Since :
4.0

Function Documentation

int wifi_manager_activate ( wifi_manager_h  wifi,
wifi_manager_activated_cb  callback,
void *  user_data 
)

Activates Wi-Fi asynchronously.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.set
http://tizen.org/privilege/network.get
Remarks:
This function needs both privileges.
Parameters:
[in]wifiThe Wi-Fi handle
[in]callbackThe callback function to be called
This can be NULL if you don't want to get the notification.
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_SECURITY_RESTRICTEDRestricted by security system policy
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Postcondition:
wifi_manager_activated_cb() will be invoked.
See also:
wifi_manager_activated_cb()
wifi_manager_deactivate()

Activates Wi-Fi asynchronously and displays Wi-Fi picker (popup) when Wi-Fi is not automatically connected.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.set
http://tizen.org/privilege/network.get
Remarks:
This function needs both privileges.
Parameters:
[in]wifiThe Wi-Fi handle
[in]callbackThe callback function to be called
This can be NULL if you don't want to get the notification.
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_SECURITY_RESTRICTEDRestricted by security system policy
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Postcondition:
wifi_manager_activated_cb() will be invoked.
See also:
wifi_manager_activated_cb()
wifi_manager_deactivate()

Stops ongoing WPS provisioning / disconnects from the connected access point.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.set
http://tizen.org/privilege/network.get
Remarks:
This function needs both privileges.
Parameters:
[in]wifiThe Wi-Fi handle
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
int wifi_manager_connect ( wifi_manager_h  wifi,
wifi_manager_ap_h  ap,
wifi_manager_connected_cb  callback,
void *  user_data 
)

Connects to the access point asynchronously.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.set
http://tizen.org/privilege/network.get
Remarks:
This function needs both privileges.
Parameters:
[in]wifiThe Wi-Fi handle
[in]apThe access point handle
[in]callbackThe callback function to be called
This can be NULL if you don't want to get the notification.
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Postcondition:
This function invokes wifi_manager_connected_cb().
See also:
wifi_manager_connected_cb()
wifi_manager_connect_by_wps_pbc()
wifi_manager_connect_by_wps_pin()
wifi_manager_disconnect()
int wifi_manager_connect_by_wps_pbc ( wifi_manager_h  wifi,
wifi_manager_ap_h  ap,
wifi_manager_connected_cb  callback,
void *  user_data 
)

Connects to the access point with WPS PBC asynchronously.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.profile
http://tizen.org/privilege/network.get
Remarks:
This function needs both privileges.
Parameters:
[in]wifiThe Wi-Fi handle
[in]apThe access point handle
[in]callbackThe callback function to be called
This can be NULL if you don't want to get the notification.
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Postcondition:
This function invokes wifi_manager_connected_cb().
See also:
wifi_manager_connected_cb()
wifi_manager_connect()
wifi_manager_disconnect()
wifi_manager_ap_is_wps_supported()

Connects to the access point with WPS PBC without entering SSID.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.set
http://tizen.org/privilege/network.get
http://tizen.org/privilege/network.profile
Remarks:
This function needs all listed privileges.
Parameters:
[in]wifiThe Wi-Fi handle
[in]callbackThe callback function to be called
This can be NULL if you don't want to get the notification.
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Postcondition:
This function invokes wifi_connected_cb().
See also:
wifi_manager_connected_cb()
wifi_manager_connect()
wifi_manager_disconnect()
wifi_manager_ap_is_wps_supported()
int wifi_manager_connect_by_wps_pin ( wifi_manager_h  wifi,
wifi_manager_ap_h  ap,
const char *  pin,
wifi_manager_connected_cb  callback,
void *  user_data 
)

Connects to the access point with WPS PIN asynchronously.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.profile
http://tizen.org/privilege/network.get
Remarks:
This function needs both privileges.
Parameters:
[in]wifiThe Wi-Fi handle
[in]apThe access point handle
[in]pinThe WPS PIN is a non-NULL string with length greater than 0 and less than or equal to 8
[in]callbackThe callback function to be called (this can be NULL if you don't want to get the notification)
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Postcondition:
This function invokes wifi_manager_connected_cb().
See also:
wifi_manager_connected_cb()
wifi_manager_connect()
wifi_manager_disconnect()
wifi_manager_ap_is_wps_supported()
int wifi_manager_connect_by_wps_pin_without_ssid ( wifi_manager_h  wifi,
const char *  pin,
wifi_manager_connected_cb  callback,
void *  user_data 
)

Connects to the access point with WPS PIN without entering SSID.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.set
http://tizen.org/privilege/network.get
http://tizen.org/privilege/network.profile
Remarks:
This function needs all listed privileges.
Parameters:
[in]wifiThe Wi-Fi handle
[in]pinThe WPS PIN, a non-NULL string with length greater
than 0 and less than or equal to 8
[in]callbackThe callback function to be called
This can be NULL if you don't want to get the notification.
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Postcondition:
This function invokes wifi_connected_cb().
See also:
wifi_manager_connected_cb()
wifi_manager_connect()
wifi_manager_disconnect()
wifi_manager_ap_is_wps_supported()
int wifi_manager_connect_hidden_ap ( wifi_manager_h  wifi,
const char *  essid,
wifi_manager_security_type_e  sec_type,
const char *  passphrase,
wifi_manager_connected_cb  callback,
void *  user_data 
)

Connects to the hidden AP, asynchronously.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.set
http://tizen.org/privilege/network.get
http://tizen.org/privilege/network.profile
Remarks:
This function needs all listed privileges.
Parameters:
[in]wifiThe Wi-Fi handle
[in]essidThe ESSID of the hidden AP
[in]sec_typeThe security type of the hidden AP
[in]passphraseThe passphrase of the hidden AP
[in]callbackThe callback function to be called
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value.
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Precondition:
This function needs wifi_manager_scan() before use.
Postcondition:
This function invokes wifi_manager_connected_cb().
int wifi_manager_deactivate ( wifi_manager_h  wifi,
wifi_manager_deactivated_cb  callback,
void *  user_data 
)

Deactivates Wi-Fi asynchronously.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.set
http://tizen.org/privilege/network.get
Remarks:
This function needs both privileges.
Parameters:
[in]wifiThe Wi-Fi handle
[in]callbackThe callback function to be called
This can be NULL if you don't want to get the notification.
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Postcondition:
wifi_manager_deactivated_cb() will be invoked.
See also:
wifi_manager_deactivated_cb()
wifi_manager_activate()
int wifi_manager_disconnect ( wifi_manager_h  wifi,
wifi_manager_ap_h  ap,
wifi_manager_disconnected_cb  callback,
void *  user_data 
)

Disconnects to the access point asynchronously.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.set
http://tizen.org/privilege/network.get
Remarks:
This function needs both privileges.
Parameters:
[in]wifiThe Wi-Fi handle
[in]apThe access point handle
[in]callbackThe callback function to be called
This can be NULL if you don't want to get the notification.
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Postcondition:
This function invokes wifi_manager_disconnected_cb().
See also:
wifi_manager_disconnected_cb()
wifi_manager_connect_by_wps_pbc()
wifi_manager_connect_by_wps_pin()
wifi_manager_connect()
int wifi_manager_foreach_found_ap ( wifi_manager_h  wifi,
wifi_manager_found_ap_cb  callback,
void *  user_data 
)

Gets the result of the scan.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.get
Parameters:
[in]wifiThe Wi-Fi handle
[in]callbackThe callback to be called
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Postcondition:
This function invokes wifi_manager_found_ap_cb().
int wifi_manager_foreach_found_bssid_ap ( wifi_manager_h  wifi,
wifi_manager_found_ap_cb  callback,
void *  user_data 
)

Gets the result of the BSSID scan (i.e. BSSID, ESSID & RSSI).

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.get
Parameters:
[in]wifiThe Wi-Fi handle
[in]callbackThe callback to be called
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Postcondition:
This function invokes wifi_manager_found_ap_cb().
See also:
wifi_manager_scan_ap()
wifi_manager_scan_specific_ap()
int wifi_manager_foreach_found_specific_ap ( wifi_manager_h  wifi,
wifi_manager_found_ap_cb  callback,
void *  user_data 
)

Gets the result of specific AP scan.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.get
Parameters:
[in]wifiThe Wi-Fi handle
[in]callbackThe callback to be called
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value.
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Postcondition:
This function invokes wifi_manager_found_ap_cb().
See also:
wifi_manager_scan_specific_ap()

Deletes the information of a stored access point and disconnects from it if it was connected to.

If an AP is connected to, then connection information will be stored. This information is used when a connection to that AP is established automatically.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.profile
http://tizen.org/privilege/network.get
Remarks:
This function needs both privileges.
Parameters:
[in]wifiThe Wi-Fi handle
[in]apThe access point handle
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported

Gets the handle of the connected access point.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.get
Remarks:
You must release ap using wifi_manager_ap_destroy().
Parameters:
[in]wifiThe Wi-Fi handle
[out]apThe access point handle
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORYOut of memory
WIFI_MANAGER_ERROR_NO_CONNECTIONThere is no connected AP
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
int wifi_manager_get_mac_address ( wifi_manager_h  wifi,
char **  mac_address 
)

Gets the local MAC address.

Since :
3.0
Remarks:
You must release mac_address using free().
Parameters:
[in]wifiThe Wi-Fi handle
[out]mac_addressThe MAC address
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
int wifi_manager_get_network_interface_name ( wifi_manager_h  wifi,
char **  name 
)

Gets the name of the network interface.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.get
Remarks:
You must release name using free().
Parameters:
[in]wifiThe Wi-Fi handle
[out]nameThe name of network interface
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORYOut of memory
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported

Gets the Wi-Fi scan state.

Since :
4.0
Parameters:
[in]wifiThe Wi-Fi handle
[in]scan_stateThe Wi-Fi scan state
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
int wifi_manager_is_activated ( wifi_manager_h  wifi,
bool *  activated 
)

Checks whether Wi-Fi is activated.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.get
Parameters:
[in]wifiThe Wi-Fi handle
[out]activatedtrue if Wi-Fi is activated, otherwise false if Wi-Fi is not activated.
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
int wifi_manager_scan ( wifi_manager_h  wifi,
wifi_manager_scan_finished_cb  callback,
void *  user_data 
)

Starts scan asynchronously.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.set
http://tizen.org/privilege/network.get
Remarks:
This function needs both privileges.
Parameters:
[in]wifiThe Wi-Fi handle
[in]callbackThe callback function to be called
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Postcondition:
This function invokes wifi_manager_scan_finished_cb().
int wifi_manager_scan_specific_ap ( wifi_manager_h  wifi,
const char *  essid,
wifi_manager_scan_finished_cb  callback,
void *  user_data 
)

Starts specific AP scan, asynchronously.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.set
http://tizen.org/privilege/network.get
Remarks:
This function needs both privileges.
Parameters:
[in]wifiThe Wi-Fi handle
[in]essidThe essid of specific AP
[in]callbackThe callback function to be called
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value.
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Postcondition:
This function invokes wifi_manager_scan_finished_cb().

Starts multi SSID and multi channel specific scan, asynchronously.

Since :
4.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.set
http://tizen.org/privilege/network.get
Remarks:
This function needs both privileges.
Parameters:
[in]wifiThe Wi-Fi handle
[in]specific_scanThe Wi-Fi specific AP scan handle
[in]callbackThe callback function to be called
[in]user_dataThe user data passed to the callback function
Returns:
0 on success, otherwise negative error value.
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_OPERATION_FAILEDOperation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Postcondition:
This function invokes wifi_manager_scan_finished_cb().

Creates a Wi-Fi specific AP scan handle.

Since :
4.0
Remarks:
You must release specific_scan using wifi_manager_specific_scan_destroy().
Parameters:
[in]wifiThe Wi-Fi handle
[out]specific_scanThe Wi-Fi specific AP scan handle
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORYOut of memory
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Precondition:
This function needs a wifi_manager_initialize() call before use.
See also:
wifi_manager_specific_scan_create()

Destroys a Wi-Fi specific AP scan handle.

Since :
4.0
Parameters:
[in]wifiThe Wi-Fi handle
[in]specific_scanThe Wi-Fi specific AP scan handle
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORYOut of memory
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
Precondition:
This function needs a wifi_manager_initialize() call before use.
See also:
wifi_manager_specific_scan_destroy()

Sets the channel frequency of a specific AP scan.

Since :
4.0
Parameters:
[in]specific_scanThe Wi-Fi specific AP scan handle
[in]freqThe channel frequency of specific AP scan
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORYOut of memory
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
See also:
wifi_manager_specific_scan_set_freq()
int wifi_manager_specific_scan_set_ssid ( wifi_manager_specific_scan_h  specific_scan,
const char *  essid 
)

Sets the SSID of a specific AP scan.

Since :
4.0
Parameters:
[in]specific_scanThe Wi-Fi specific AP scan handle
[in]essidThe SSID of specific AP scan
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORYOut of memory
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported
See also:
wifi_manager_specific_scan_set_ssid()

Updates an existing AP.

When a AP is changed, these changes will be not applied to the Connection Manager immediately. When you call this function, your changes affect the Connection Manager and the existing AP is updated.

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/network.profile
http://tizen.org/privilege/network.get
Remarks:
This function needs both privileges.
Parameters:
[in]wifiThe Wi-Fi handle
[in]apThe access point handle
Returns:
0 on success, otherwise negative error value
Return values:
WIFI_MANAGER_ERROR_NONESuccessful
WIFI_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATIONInvalid operation
WIFI_MANAGER_ERROR_PERMISSION_DENIEDPermission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTEDNot supported