The Wi-Fi API provides functions for monitoring the state of Wi-Fi.
Required Header
#include <wifi.h>
Overview
The Wi-Fi Monitor allows monitoring the changes of Wi-Fi.
Related Features
This API is related with the following features:
It is recommended to design feature related codes in your application for reliability.
You can check if a device supports the related features for this API by using System Information, thereby controlling the procedure of your application.
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 List.
Typedef Documentation
Enumeration Type Documentation
Enumeration for the state of the Wi-Fi connection.
- Since :
- 2.3
- Enumerator:
WIFI_CONNECTION_STATE_FAILURE |
Connection failed state
|
WIFI_CONNECTION_STATE_DISCONNECTED |
Disconnected state
|
WIFI_CONNECTION_STATE_ASSOCIATION |
Association state
|
WIFI_CONNECTION_STATE_CONFIGURATION |
Configuration state
|
WIFI_CONNECTION_STATE_CONNECTED |
Connected state
|
Enumeration for the state of the Wi-Fi device.
- Since :
- 2.3
- Enumerator:
WIFI_DEVICE_STATE_DEACTIVATED |
Wi-Fi is Deactivated
|
WIFI_DEVICE_STATE_ACTIVATED |
Wi-Fi is activated
|
Enumeration for the RSSI level.
- Since :
- 2.3
- Enumerator:
WIFI_RSSI_LEVEL_0 |
level 0
|
WIFI_RSSI_LEVEL_1 |
level 1
|
WIFI_RSSI_LEVEL_2 |
level 2
|
WIFI_RSSI_LEVEL_3 |
level 3
|
WIFI_RSSI_LEVEL_4 |
level 4
|
Function Documentation
Gets the connection state.
- Since :
- 2.3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/network.get
- Parameters:
-
[out] | connection_state | The connection state |
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
Registers the callback called when the background scan is finished periodically.
- Since :
- 2.3
- Parameters:
-
[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:
-
Registers the callback called when the connection state is changed.
- Since :
- 2.3
- Parameters:
-
[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:
-
Registers the callback called when the device state is changed.
- Since :
- 2.3
- Parameters:
-
[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:
-
Registers callback called when the RSSI of connected Wi-Fi is changed.
- Since :
- 2.3
- Parameters:
-
[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:
-
Unregisters the callback called when the scan is finished periodically.
- Since :
- 2.3
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
Unregisters the callback called when the connection state is changed.
- Since :
- 2.3
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
Unregisters the callback called when the device state is changed.
- Since :
- 2.3
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
Unregisters callback called when the RSSI of connected Wi-Fi is changed.
- Since :
- 2.3
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-