Tizen Native API
3.0
|
The Connection Information API provides functions for managing the network information.
Required Header
#include <wifi.h>
Overview
The Connection Information API provides functions for managing the network information. You can manage the network information using the functions.
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_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 Type Documentation
Enumeration for the address type.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_address_family_e instead.
- Since :
- 2.3.1
Enumeration for the Net IP configuration type.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ip_config_type_e instead.
- Since :
- 2.3.1
- Enumerator:
enum wifi_proxy_type_e |
Enumeration for the proxy method type.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_proxy_type_e instead.
- Since :
- 2.3.1
Function Documentation
int wifi_ap_get_bssid | ( | wifi_ap_h | ap, |
char ** | bssid | ||
) |
Gets BSSID (Basic Service Set Identifier).
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_get_bssid() instead.
- Since :
- 2.3.1
- Remarks:
- You must release bssid using free().
- Parameters:
-
[in] ap The access point handle [out] bssid The BSSID
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_get_connection_state() instead.
- Since :
- 2.3.1
- Parameters:
-
[in] ap The access point handle [out] state The connection state
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_get_dns_address() instead.
- Since :
- 2.3.1
- Remarks:
- The allowance of DNS address is
2.You
must release dns_address using free().
- Parameters:
-
[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
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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).
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_get_essid() instead.
- Since :
- 2.3.1
- Remarks:
- You must release essid using free().
- Parameters:
-
[in] ap The access point handle [out] essid The ESSID
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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).
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_get_frequency() instead.
- Since :
- 2.3.1
- Parameters:
-
[in] ap The access point handle [out] frequency The frequency
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_get_gateway_address() instead.
- Since :
- 2.3.1
- Remarks:
- You must release gateway_address using free().
- Parameters:
-
[in] ap The access point handle [in] address_family The address family [out] gateway_address The gateway address
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_get_ip_address() instead.
- Since :
- 2.3.1
- Remarks:
- You must release ip_address using free().
- Parameters:
-
[in] ap The access point handle [in] address_family The address family [out] ip_address The IP address
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_get_ip_config_type() instead.
- Since :
- 2.3.1
- Parameters:
-
[in] ap The access point handle [in] address_family The address family [out] type The type of IP config
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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).
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_get_max_speed() instead.
- Since :
- 2.3.1
- Parameters:
-
[in] ap The access point handle [out] max_speed The max speed
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_get_proxy_address() instead.
- Since :
- 2.3.1
- Remarks:
- You must release proxy_address using free().
- Parameters:
-
[in] ap The access point handle [in] address_family The address family [out] proxy_address The proxy address
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_get_proxy_type() instead.
- Since :
- 2.3.1
- Parameters:
-
[in] ap The access point handle [out] type The type of proxy
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_get_rssi() instead.
- Since :
- 2.3.1
- Parameters:
-
[in] ap The access point handle [out] rssi The RSSI
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_get_subnet_mask() instead.
- Since :
- 2.3.1
- Remarks:
- You must release subnet_mask using free().
- Parameters:
-
[in] ap The access point handle [in] address_family The address family [out] subnet_mask The subnet mask
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_is_favorite() instead.
- Since :
- 2.3.1
- Parameters:
-
[in] ap The access point handle [out] favorite true
if access point is favorite, otherwisefalse
if access point is not favorite
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_is_passpoint() instead.
- Since :
- 2.3.1
- Parameters:
-
[in] ap The access point handle [out] passpoint ture
if access point is passpoint, otherwisefalse
if access point is not passpoint.
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_set_dns_address() instead.
- Since :
- 2.3.1
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/network.profile
http://tizen.org/privilege/network.get
- Remarks:
- The allowance of DNS address is
2
This API needs both privileges.
- Parameters:
-
[in] ap The access point handle [in] order The order of DNS address
It starts from1
, which means first DNS address.[in] address_family The address family [in] dns_address The DNS address
If you set this value toNULL
, then the existing value will be deleted.
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_set_gateway_address() instead.
- Since :
- 2.3.1
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/network.profile
http://tizen.org/privilege/network.get
- Remarks:
- This API needs both privileges.
- Parameters:
-
[in] ap The access point handle [in] address_family The address family [in] gateway_address The gateway address
If you set this value toNULL
, then the existing value will be deleted.
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_set_ip_address() instead.
- Since :
- 2.3.1
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/network.profile
http://tizen.org/privilege/network.get
- Remarks:
- This API needs both privileges.
- Parameters:
-
[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
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_set_ip_config_type() instead.
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".
- Since :
- 2.3.1
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/network.profile
http://tizen.org/privilege/network.get
- Remarks:
- This API needs both privileges.
- Parameters:
-
[in] ap The access point handle [in] address_family The address family [in] type The type of IP config
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_set_proxy_address() instead.
- Since :
- 2.3.1
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/network.profile
http://tizen.org/privilege/network.get
- Remarks:
- This API needs both privileges.
- Parameters:
-
[in] ap The access point handle [in] address_family The address family [in] proxy_address The proxy address
If you set this value toNULL
, then the existing value will be deleted.
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_set_proxy_type() instead.
If you set Proxy type to WIFI_PROXY_TYPE_AUTO or WIFI_PROXY_TYPE_MANUAL, then Proxy will be restored.
- Since :
- 2.3.1
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/network.profile
http://tizen.org/privilege/network.get
- Remarks:
- This API needs both privileges.
- Parameters:
-
[in] ap The access point handle [in] proxy_type The type of proxy
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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.
- Deprecated:
- Deprecated since 3.0. Use wifi_manager_ap_set_subnet_mask() instead.
- Since :
- 2.3.1
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/network.profile
http://tizen.org/privilege/network.get
- Remarks:
- This API needs both privileges.
- Parameters:
-
[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
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
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