Tizen Native API
|
The Connection Information API provides functions for managing the network information.
#include <wifi.h>
The Connection Information API provides functions for managing the network information. You can manage the network information using the functions.
This API is related with the following features:
Functions | |
int | wifi_ap_get_essid (wifi_ap_h ap, char **essid) TIZEN_DEPRECATED_API |
Gets ESSID (Extended Service Set Identifier). | |
int | wifi_ap_get_bssid (wifi_ap_h ap, char **bssid) TIZEN_DEPRECATED_API |
Gets BSSID (Basic Service Set Identifier). | |
int | wifi_ap_get_rssi (wifi_ap_h ap, int *rssi) TIZEN_DEPRECATED_API |
Gets the RSSI. | |
int | wifi_ap_get_frequency (wifi_ap_h ap, int *frequency) TIZEN_DEPRECATED_API |
Gets the frequency band (MHz). | |
int | wifi_ap_get_max_speed (wifi_ap_h ap, int *max_speed) TIZEN_DEPRECATED_API |
Gets the max speed (Mbps). | |
int | wifi_ap_is_favorite (wifi_ap_h ap, bool *favorite) TIZEN_DEPRECATED_API |
Checks whether the access point is favorite or not. | |
int | wifi_ap_is_passpoint (wifi_ap_h ap, bool *passpoint) TIZEN_DEPRECATED_API |
Checks whether the access point is passpoint or not. | |
int | wifi_ap_get_connection_state (wifi_ap_h ap, wifi_connection_state_e *state) TIZEN_DEPRECATED_API |
Gets the connection state. | |
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 |
Gets the config type of IP. | |
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 |
Sets the config type of IP. | |
int | wifi_ap_get_ip_address (wifi_ap_h ap, wifi_address_family_e address_family, char **ip_address) TIZEN_DEPRECATED_API |
Gets the IP address. | |
int | wifi_ap_set_ip_address (wifi_ap_h ap, wifi_address_family_e address_family, const char *ip_address) TIZEN_DEPRECATED_API |
Sets the IP address. | |
int | wifi_ap_get_subnet_mask (wifi_ap_h ap, wifi_address_family_e address_family, char **subnet_mask) TIZEN_DEPRECATED_API |
Gets the subnet mask. | |
int | wifi_ap_set_subnet_mask (wifi_ap_h ap, wifi_address_family_e address_family, const char *subnet_mask) TIZEN_DEPRECATED_API |
Sets the subnet mask. | |
int | wifi_ap_get_gateway_address (wifi_ap_h ap, wifi_address_family_e address_family, char **gateway_address) TIZEN_DEPRECATED_API |
Gets the gateway address. | |
int | wifi_ap_set_gateway_address (wifi_ap_h ap, wifi_address_family_e address_family, const char *gateway_address) TIZEN_DEPRECATED_API |
Sets the gateway address. | |
int | wifi_ap_get_proxy_address (wifi_ap_h ap, wifi_address_family_e address_family, char **proxy_address) TIZEN_DEPRECATED_API |
Gets the proxy address. | |
int | wifi_ap_set_proxy_address (wifi_ap_h ap, wifi_address_family_e address_family, const char *proxy_address) TIZEN_DEPRECATED_API |
Sets the proxy address. | |
int | wifi_ap_get_proxy_type (wifi_ap_h ap, wifi_proxy_type_e *type) TIZEN_DEPRECATED_API |
Gets the Proxy type. | |
int | wifi_ap_set_proxy_type (wifi_ap_h ap, wifi_proxy_type_e proxy_type) TIZEN_DEPRECATED_API |
Sets the Proxy address. | |
int | wifi_ap_get_dns_address (wifi_ap_h ap, int order, wifi_address_family_e address_family, char **dns_address) TIZEN_DEPRECATED_API |
Gets the DNS address. | |
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 |
Sets the DNS address. |
Enumeration for the address type.
Enumeration for the Net IP configuration type.
enum wifi_proxy_type_e |
Enumeration for the proxy method type.
int wifi_ap_get_bssid | ( | wifi_ap_h | ap, |
char ** | bssid | ||
) |
Gets BSSID (Basic Service Set Identifier).
[in] | ap | The access point handle |
[out] | bssid | The BSSID |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OUT_OF_MEMORY | Out of memory |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_get_connection_state | ( | wifi_ap_h | ap, |
wifi_connection_state_e * | state | ||
) |
Gets the connection state.
[in] | ap | The access point handle |
[out] | state | The connection state |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OPERATION_FAILED | Operation failed |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_get_dns_address | ( | wifi_ap_h | ap, |
int | order, | ||
wifi_address_family_e | address_family, | ||
char ** | dns_address | ||
) |
Gets the DNS address.
2.You
must release dns_address using free(). [in] | ap | The access point handle |
[in] | order | The order of DNS address; it starts from 1, which means first DNS address |
[in] | address_family | The address family |
[out] | dns_address | The DNS address |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OUT_OF_MEMORY | Out of memory |
WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED | Address family not supported |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_get_essid | ( | wifi_ap_h | ap, |
char ** | essid | ||
) |
Gets ESSID (Extended Service Set Identifier).
[in] | ap | The access point handle |
[out] | essid | The ESSID |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OUT_OF_MEMORY | Out of memory |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_get_frequency | ( | wifi_ap_h | ap, |
int * | frequency | ||
) |
Gets the frequency band (MHz).
[in] | ap | The access point handle |
[out] | frequency | The frequency |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OPERATION_FAILED | Operation failed |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_get_gateway_address | ( | wifi_ap_h | ap, |
wifi_address_family_e | address_family, | ||
char ** | gateway_address | ||
) |
Gets the gateway address.
[in] | ap | The access point handle |
[in] | address_family | The address family |
[out] | gateway_address | The gateway address |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OUT_OF_MEMORY | Out of memory |
WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED | Address family not supported |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_get_ip_address | ( | wifi_ap_h | ap, |
wifi_address_family_e | address_family, | ||
char ** | ip_address | ||
) |
Gets the IP address.
[in] | ap | The access point handle |
[in] | address_family | The address family |
[out] | ip_address | The IP address |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OUT_OF_MEMORY | Out of memory |
WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED | Address family not supported |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_get_ip_config_type | ( | wifi_ap_h | ap, |
wifi_address_family_e | address_family, | ||
wifi_ip_config_type_e * | type | ||
) |
Gets the config type of IP.
[in] | ap | The access point handle |
[in] | address_family | The address family |
[out] | type | The type of IP config |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OPERATION_FAILED | Operation failed |
WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED | Address family not supported |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_get_max_speed | ( | wifi_ap_h | ap, |
int * | max_speed | ||
) |
Gets the max speed (Mbps).
[in] | ap | The access point handle |
[out] | max_speed | The max speed |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OPERATION_FAILED | Operation failed |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_get_proxy_address | ( | wifi_ap_h | ap, |
wifi_address_family_e | address_family, | ||
char ** | proxy_address | ||
) |
Gets the proxy address.
[in] | ap | The access point handle |
[in] | address_family | The address family |
[out] | proxy_address | The proxy address |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OUT_OF_MEMORY | Out of memory |
WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED | Address family not supported |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_get_proxy_type | ( | wifi_ap_h | ap, |
wifi_proxy_type_e * | type | ||
) |
Gets the Proxy type.
[in] | ap | The access point handle |
[out] | type | The type of proxy |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OPERATION_FAILED | Operation failed |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_get_rssi | ( | wifi_ap_h | ap, |
int * | rssi | ||
) |
Gets the RSSI.
[in] | ap | The access point handle |
[out] | rssi | The RSSI |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OPERATION_FAILED | Operation failed |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_get_subnet_mask | ( | wifi_ap_h | ap, |
wifi_address_family_e | address_family, | ||
char ** | subnet_mask | ||
) |
Gets the subnet mask.
[in] | ap | The access point handle |
[in] | address_family | The address family |
[out] | subnet_mask | The subnet mask |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OUT_OF_MEMORY | Out of memory |
WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED | Address family not supported |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_is_favorite | ( | wifi_ap_h | ap, |
bool * | favorite | ||
) |
Checks whether the access point is favorite or not.
[in] | ap | The access point handle |
[out] | favorite | true if access point is favorite, otherwise false if access point is not favorite |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OPERATION_FAILED | Operation failed |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_is_passpoint | ( | wifi_ap_h | ap, |
bool * | passpoint | ||
) |
Checks whether the access point is passpoint or not.
[in] | ap | The access point handle |
[out] | passpoint | ture if access point is passpoint, otherwise false if access point is not passpoint. |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OPERATION_FAILED | Operation failed |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_set_dns_address | ( | wifi_ap_h | ap, |
int | order, | ||
wifi_address_family_e | address_family, | ||
const char * | dns_address | ||
) |
Sets the DNS address.
2
[in] | ap | The access point handle |
[in] | order | The order of DNS address It starts from 1 , which means first DNS address. |
[in] | address_family | The address family |
[in] | dns_address | The DNS address If you set this value to NULL , then the existing value will be deleted. |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OPERATION_FAILED | Operation failed |
WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED | Address family not supported |
WIFI_ERROR_PERMISSION_DENIED | Permission Denied |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_set_gateway_address | ( | wifi_ap_h | ap, |
wifi_address_family_e | address_family, | ||
const char * | gateway_address | ||
) |
Sets the gateway address.
[in] | ap | The access point handle |
[in] | address_family | The address family |
[in] | gateway_address | The gateway address If you set this value to NULL , then the existing value will be deleted. |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OPERATION_FAILED | Operation failed |
WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED | Address family not supported |
WIFI_ERROR_PERMISSION_DENIED | Permission Denied |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_set_ip_address | ( | wifi_ap_h | ap, |
wifi_address_family_e | address_family, | ||
const char * | ip_address | ||
) |
Sets the IP address.
[in] | ap | The access point handle |
[in] | address_family | The address family |
[in] | ip_address | The IP address; if you set this value to NULL, then the existing value will be deleted |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OPERATION_FAILED | Operation failed |
WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED | Address family not supported |
WIFI_ERROR_PERMISSION_DENIED | Permission Denied |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_set_ip_config_type | ( | wifi_ap_h | ap, |
wifi_address_family_e | address_family, | ||
wifi_ip_config_type_e | type | ||
) |
Sets the config type of IP.
If you set IP config type to WIFI_IP_CONFIG_TYPE_STATIC, then IP address, Gateway and Subnet mask will be set to the initial value "0.0.0.0".
[in] | ap | The access point handle |
[in] | address_family | The address family |
[in] | type | The type of IP config |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OPERATION_FAILED | Operation failed |
WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED | Address family not supported |
WIFI_ERROR_PERMISSION_DENIED | Permission Denied |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_set_proxy_address | ( | wifi_ap_h | ap, |
wifi_address_family_e | address_family, | ||
const char * | proxy_address | ||
) |
Sets the proxy address.
[in] | ap | The access point handle |
[in] | address_family | The address family |
[in] | proxy_address | The proxy address If you set this value to NULL , then the existing value will be deleted. |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OPERATION_FAILED | Operation failed |
WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED | Address family not supported |
WIFI_ERROR_PERMISSION_DENIED | Permission Denied |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_set_proxy_type | ( | wifi_ap_h | ap, |
wifi_proxy_type_e | proxy_type | ||
) |
Sets the Proxy address.
If you set Proxy type to WIFI_PROXY_TYPE_AUTO or WIFI_PROXY_TYPE_MANUAL, then Proxy will be restored.
[in] | ap | The access point handle |
[in] | proxy_type | The type of proxy |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OPERATION_FAILED | Operation failed |
WIFI_ERROR_PERMISSION_DENIED | Permission Denied |
WIFI_ERROR_NOT_SUPPORTED | Not supported |
int wifi_ap_set_subnet_mask | ( | wifi_ap_h | ap, |
wifi_address_family_e | address_family, | ||
const char * | subnet_mask | ||
) |
Sets the subnet mask.
[in] | ap | The access point handle |
[in] | address_family | The address family |
[in] | subnet_mask | The subnet mask; if you set this value to NULL, then the existing value will be deleted |
WIFI_ERROR_NONE | Successful |
WIFI_ERROR_INVALID_PARAMETER | Invalid parameter |
WIFI_ERROR_OPERATION_FAILED | Operation failed |
WIFI_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED | Address family not supported |
WIFI_ERROR_PERMISSION_DENIED | Permission Denied |
WIFI_ERROR_NOT_SUPPORTED | Not supported |