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_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:

http://tizen.org/feature/network.wifi
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 using features in your application can be found in the Feature List.

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_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_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_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_forget_ap (wifi_manager_h wifi, wifi_manager_ap_h ap)
	Deletes the information of a stored access point and disconnects it if it was connected.
int	wifi_manager_update_ap (wifi_manager_h wifi, wifi_manager_ap_h ap)
	Updates an existing AP.
Typedefs
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_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 after either wifi_manager_connect() or wifi_manager_connect_by_wps_pbc() or wifi_manager_connect_by_wps_pin() are completed.
typedef void(*	wifi_manager_disconnected_cb )(wifi_manager_error_e result, void *user_data)
	Called after wifi_manager_disconnect() is completed.

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]	result	The result
[in]	user_data	The 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_connected_cb)(wifi_manager_error_e result, void *user_data)

Called after either wifi_manager_connect() or wifi_manager_connect_by_wps_pbc() or wifi_manager_connect_by_wps_pin() are completed.

Since :: 3.0

Parameters:

[in]	result	The result
[in]	user_data	The user data passed from either wifi_manager_connect() or wifi_manager_connect_by_wps_pbc() or wifi_manager_connect_by_wps_pin()

Precondition:: Either wifi_manager_connect() or wifi_manager_connect_by_wps_pbc() or wifi_manager_connect_by_wps_pin() will invoke this callback function.

See also:: wifi_manager_connect(); wifi_manager_connect_by_wps_pbc(); wifi_manager_connect_by_wps_pin()

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]	result	The result
[in]	user_data	The 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]	result	The result
[in]	user_data	The 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]	ap	The access point
[in]	user_data	The 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_code	The error code
[in]	user_data	The 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()

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 API needs both privileges.

Parameters:

[in]	wifi	The wifi handle
[in]	callback	The callback function to be called This can be `NULL` if you don't want to get the notification.
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_SECURITY_RESTRICTED	Restricted by security system policy
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

Postcondition:: wifi_manager_activated_cb() will be invoked.

See also:: wifi_manager_activated_cb(); wifi_manager_deactivate()

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.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/network.set
http://tizen.org/privilege/network.get

Remarks:: This API needs both privileges.

Parameters:

[in]	wifi	The wifi handle
[in]	callback	The callback function to be called This can be `NULL` if you don't want to get the notification.
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_SECURITY_RESTRICTED	Restricted by security system policy
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

Postcondition:: wifi_manager_activated_cb() will be invoked.

See also:: wifi_manager_activated_cb(); wifi_manager_deactivate()

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 API needs both privileges.

Parameters:

[in]	wifi	The wifi handle
[in]	ap	The access point handle
[in]	callback	The callback function to be called This can be `NULL` if you don't want to get the notification.
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not 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 API needs both privileges.

Parameters:

[in]	wifi	The wifi handle
[in]	ap	The access point handle
[in]	callback	The callback function to be called This can be NULL if you don't want to get the notification.
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not 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	(	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 API needs both privileges.

Parameters:

[in]	wifi	The wifi handle
[in]	ap	The access point handle
[in]	pin	The WPS PIN is a non-NULL string with length greater than 0 and less than or equal to 8
[in]	callback	The callback function to be called (this can be NULL if you don't want to get the notification)
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not 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_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 API needs both privileges.

Parameters:

[in]	wifi	The wifi handle
[in]	callback	The callback function to be called This can be `NULL` if you don't want to get the notification.
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not 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 API needs both privileges.

Parameters:

[in]	wifi	The wifi handle
[in]	ap	The access point handle
[in]	callback	The callback function to be called This can be `NULL` if you don't want to get the notification.
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not 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]	wifi	The wifi handle
[in]	callback	The callback to be called
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

Postcondition:: This function invokes wifi_manager_found_ap_cb().

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]	wifi	The wifi handle
[in]	callback	The callback to be called
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value.

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

Postcondition:: This function invokes wifi_manager_found_ap_cb().

See also:: wifi_manager_scan_specific_ap()

int wifi_manager_forget_ap	(	wifi_manager_h	wifi,
		wifi_manager_ap_h	ap
	)

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

If an AP is connected, 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 API needs both privileges.

Parameters:

[in]	wifi	The wifi handle
[in]	ap	The access point handle

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_get_connected_ap	(	wifi_manager_h	wifi,
		wifi_manager_ap_h *	ap
	)

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 handle using wifi_manager_ap_destroy().

Parameters:

[in]	wifi	The wifi handle
[out]	ap	The access point handle

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_MANAGER_ERROR_NO_CONNECTION	There is no connected AP
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not 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]	wifi	The wifi handle
[out]	mac_address	The MAC address

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not 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]	wifi	The wifi handle
[out]	name	The name of network interface

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not 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]	wifi	The wifi handle
[out]	activated	`true` 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_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not 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 API needs both privileges.

Parameters:

[in]	wifi	The wifi handle
[in]	callback	The callback function to be called
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not 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 API needs both privileges.

Parameters:

[in]	wifi	The wifi handle
[in]	essid	The essid of hidden AP
[in]	callback	The callback function to be called
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value.

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

Postcondition:: This function invokes wifi_manager_scan_finished_cb().

int wifi_manager_update_ap	(	wifi_manager_h	wifi,
		wifi_manager_ap_h	ap
	)

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 API needs both privileges.

Parameters:

[in]	wifi	The wifi handle
[in]	ap	The access point handle

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

Required Header

Overview

Related Features

Functions

Typedefs

Typedef Documentation

Function Documentation