|
Tizen Native API
5.0
|
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 | true 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 |