The Configuration API offers functionalities for managing the configuration of Wi-Fi.

Required Header

#include <wifi-manager.h>

Overview

The Configuration API offers functionalities for managing the configuration of Wi-Fi. You can manage the configuration 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 featuring your application can be found from Feature Element.

Functions
int	wifi_manager_config_create (wifi_manager_h wifi, const char name, const char passphrase, wifi_manager_security_type_e security_type, wifi_manager_config_h *config)
	Gets access point configuration handle.
int	wifi_manager_config_clone (wifi_manager_config_h origin, wifi_manager_config_h *cloned_config)
	Clones the access point configuration handle.
int	wifi_manager_config_destroy (wifi_manager_config_h config)
	Destroys the access point configuration handle.
int	wifi_manager_config_save (wifi_manager_h wifi, wifi_manager_config_h config)
	Saves Wi-Fi configuration of access point.
int	wifi_manager_config_remove (wifi_manager_h wifi, wifi_manager_config_h config)
	Removes Wi-Fi configuration of access point.
int	wifi_manager_config_foreach_configuration (wifi_manager_h wifi, wifi_manager_config_list_cb callback, void *user_data)
	Gets configurations of an access point.
int	wifi_manager_config_get_name (wifi_manager_config_h config, char **name)
	Gets the name of access point from configuration.
int	wifi_manager_config_get_security_type (wifi_manager_config_h config, wifi_manager_security_type_e *security_type)
	Gets the security type of access point from configuration.
int	wifi_manager_config_set_proxy_address (wifi_manager_config_h config, wifi_manager_address_family_e address_family, const char *proxy_address)
	Sets access point proxy address configuration.
int	wifi_manager_config_get_proxy_address (wifi_manager_config_h config, wifi_manager_address_family_e address_family, char *proxy_address)
	Gets the proxy address of access point from configuration.
int	wifi_manager_config_set_hidden_ap_property (wifi_manager_config_h config, bool is_hidden)
	Sets the hidden property of access point from the configuration.
int	wifi_manager_config_get_hidden_ap_property (wifi_manager_config_h config, bool *is_hidden)
	Gets the hidden property of access point from the configuration.
int	wifi_manager_config_get_ip_config_type (wifi_manager_config_h config, wifi_manager_address_family_e address_family, wifi_manager_ip_config_type_e *type)
	Gets access point IP config type from configuration.
int	wifi_manager_config_set_ip_config_type (wifi_manager_config_h config, wifi_manager_address_family_e address_family, wifi_manager_ip_config_type_e type)
	Sets access point IP config type to configuration.
int	wifi_manager_config_get_ip_address (wifi_manager_config_h config, wifi_manager_address_family_e address_family, char **ip_address)
	Gets access point IP address from configuration.
int	wifi_manager_config_set_ip_address (wifi_manager_config_h config, wifi_manager_address_family_e address_family, const char *ip_address)
	Sets access point IP address to configuration.
int	wifi_manager_config_get_subnet_mask (wifi_manager_config_h config, wifi_manager_address_family_e address_family, char **subnet_mask)
	Gets access point subnet mask from configuration.
int	wifi_manager_config_set_subnet_mask (wifi_manager_config_h config, wifi_manager_address_family_e address_family, const char *subnet_mask)
	Sets access point subnet mask to configuration.
int	wifi_manager_config_get_prefix_length (wifi_manager_config_h config, wifi_manager_address_family_e address_family, int *prefix_len)
	Gets the network prefix length from configuration.
int	wifi_manager_config_set_prefix_length (wifi_manager_config_h config, wifi_manager_address_family_e address_family, int prefix_len)
	Sets the network prefix length to configuration.
int	wifi_manager_config_get_gateway_address (wifi_manager_config_h config, wifi_manager_address_family_e address_family, char **gateway_address)
	Gets access point gateway address from configuration.
int	wifi_manager_config_set_gateway_address (wifi_manager_config_h config, wifi_manager_address_family_e address_family, const char *gateway_address)
	Sets access point gateway address to configuration.
int	wifi_manager_config_get_dns_config_type (wifi_manager_config_h config, wifi_manager_address_family_e address_family, wifi_manager_dns_config_type_e *type)
	Gets access point dns config type from configuration.
int	wifi_manager_config_set_dns_config_type (wifi_manager_config_h config, wifi_manager_address_family_e address_family, wifi_manager_dns_config_type_e type)
	Sets access point dns config type to configuration.
int	wifi_manager_config_get_dns_address (wifi_manager_config_h config, int order, wifi_manager_address_family_e address_family, char **dns_address)
	Gets access point dns address from configuration.
int	wifi_manager_config_set_dns_address (wifi_manager_config_h config, int order, wifi_manager_address_family_e address_family, const char *dns_address)
	Sets access point dns address to configuration.
int	wifi_manager_config_get_eap_anonymous_identity (wifi_manager_config_h config, char **anonymous_identity)
	Gets access point anonymous identity from configuration.
int	wifi_manager_config_set_eap_anonymous_identity (wifi_manager_config_h config, const char *anonymous_identity)
	Sets access point anonymous identity to configuration.
int	wifi_manager_config_get_eap_ca_cert_file (wifi_manager_config_h config, char **ca_cert)
	Gets access point cacert file from configuration.
int	wifi_manager_config_set_eap_ca_cert_file (wifi_manager_config_h config, const char *ca_cert)
	Sets access point cacert file to configuration.
int	wifi_manager_config_get_eap_client_cert_file (wifi_manager_config_h config, char **client_cert)
	Gets access point client cert file from configuration.
int	wifi_manager_config_set_eap_client_cert_file (wifi_manager_config_h config, const char private_key, const char client_cert)
	Sets access point client cert file to configuration.
int	wifi_manager_config_get_eap_private_key_file (wifi_manager_config_h config, char **file)
	Gets the private key file of EAP.
int	wifi_manager_config_set_eap_private_key_info (wifi_manager_config_h config, const char file, const char password)
	Sets the private key information of EAP.
int	wifi_manager_config_get_eap_identity (wifi_manager_config_h config, char **identity)
	Gets access point identity from configuration.
int	wifi_manager_config_set_eap_identity (wifi_manager_config_h config, const char *identity)
	Sets access point identity to configuration.
int	wifi_manager_config_get_eap_type (wifi_manager_config_h config, wifi_manager_eap_type_e *eap_type)
	Gets access point EAP type from configuration.
int	wifi_manager_config_set_eap_type (wifi_manager_config_h config, wifi_manager_eap_type_e eap_type)
	Sets access point EAP type to configuration.
int	wifi_manager_config_get_eap_auth_type (wifi_manager_config_h config, wifi_manager_eap_auth_type_e *eap_auth_type)
	Gets access point EAP auth type from configuration.
int	wifi_manager_config_set_eap_auth_type (wifi_manager_config_h config, wifi_manager_eap_auth_type_e eap_auth_type)
	Sets access point EAP auth type to configuration.
int	wifi_manager_config_get_eap_subject_match (wifi_manager_config_h config, char **subject_match)
	Gets access point subject match from configuration.
int	wifi_manager_config_set_eap_subject_match (wifi_manager_config_h config, const char *subject_match)
	Sets access point subject match to configuration.
Typedefs
typedef void *	wifi_manager_config_h
	The Wi-Fi access point configuration handle.
typedef bool(*	wifi_manager_config_list_cb )(const wifi_manager_config_h config, void *user_data)
	Called for each found access point configuration.

Typedef Documentation

typedef void* wifi_manager_config_h

The Wi-Fi access point configuration handle.

Since :: 3.0

typedef bool(* wifi_manager_config_list_cb)(const wifi_manager_config_h config, void *user_data)

Called for each found access point configuration.

Since :: 3.0

Remarks:: config is valid only in this function. In order to use config outside this function, you must copy the config with wifi_manager_config_clone().

Parameters:

[in]	config	The access point configuration handle
[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_config_foreach_configuration() will invoke this callback.

See also:: wifi_manager_config_foreach_configuration()

Function Documentation

int wifi_manager_config_clone	(	wifi_manager_config_h	origin,
		wifi_manager_config_h *	cloned_config
	)

Clones the access point configuration handle.

Since :: 3.0

Remarks:: You must release cloned_config using wifi_manager_config_destroy().

Parameters:

[in]	origin	The origin access point configuration handle
[out]	cloned_config	The cloned access point configuration handle

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

See also:: wifi_manager_config_destroy()

int wifi_manager_config_create	(	wifi_manager_h	wifi,
		const char *	name,
		const char *	passphrase,
		wifi_manager_security_type_e	security_type,
		wifi_manager_config_h *	config
	)

Gets access point configuration handle.

Since :: 3.0

Remarks:: You must release config using wifi_manager_config_destroy().

Parameters:

[in]	wifi	The Wi-Fi handle
[in]	name	The access point name
[in]	passphrase	The access point passphrase
[in]	security_type	The access point security type
[out]	config	The access point configuration handle

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

Precondition:: This function needs a wifi_manager_initialize() call before use

See also:: wifi_manager_config_destroy()

int wifi_manager_config_destroy ( wifi_manager_config_h config )

Destroys the access point configuration handle.

Since :: 3.0

Parameters:

[in] config The access point configuration handle

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

See also:: wifi_manager_config_create(); wifi_manager_config_clone()

int wifi_manager_config_foreach_configuration	(	wifi_manager_h	wifi,
		wifi_manager_config_list_cb	callback,
		void *	user_data
	)

Gets configurations of an access point.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/network.profile

Parameters:

[in]	wifi	The Wi-Fi 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_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

Precondition:: This function needs wifi_manager_initialize() before use.

Postcondition:: This function invokes wifi_manager_config_list_cb().

int wifi_manager_config_get_dns_address	(	wifi_manager_config_h	config,
		int	order,
		wifi_manager_address_family_e	address_family,
		char **	dns_address
	)

Gets access point dns address from configuration.

Since :: 5.0

Remarks:: The allowance of DNS address is 2.You must release dns_address using free().

Parameters:

[in]	config	The access point configuration 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_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_MANAGER_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED	Address family not supported
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_config_get_dns_config_type	(	wifi_manager_config_h	config,
		wifi_manager_address_family_e	address_family,
		wifi_manager_dns_config_type_e *	type
	)

Gets access point dns config type from configuration.

Since :: 5.0

Parameters:

[in]	config	The access point configuration handle
[in]	address_family	The address family
[out]	type	The type of dns configuration

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED	Address family not supported
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_config_get_eap_anonymous_identity	(	wifi_manager_config_h	config,
		char **	anonymous_identity
	)

Gets access point anonymous identity from configuration.

Since :: 3.0

Remarks:: You must release anonymous_identity using free().

Parameters:

[in]	config	The access point configuration handle
[out]	anonymous_identity	The anonymous identity of access point

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter

int wifi_manager_config_get_eap_auth_type	(	wifi_manager_config_h	config,
		wifi_manager_eap_auth_type_e *	eap_auth_type
	)

Gets access point EAP auth type from configuration.

Since :: 3.0

Parameters:

[in]	config	The access point configuration handle
[out]	eap_auth_type	The EAP auth type of access point

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter

int wifi_manager_config_get_eap_ca_cert_file	(	wifi_manager_config_h	config,
		char **	ca_cert
	)

Gets access point cacert file from configuration.

Since :: 3.0

Remarks:: You must release ca_cert using free().; The mediastorage privilege http://tizen.org/privilege/mediastorage is needed
if ca_cert is relevant to media storage.
The externalstorage privilege http://tizen.org/privilege/externalstorage is needed
if ca_cert is relevant to external storage.

Parameters:

[in]	config	The access point configuration handle
[out]	ca_cert	The certification authority(CA) certificates file of access point

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter

int wifi_manager_config_get_eap_client_cert_file	(	wifi_manager_config_h	config,
		char **	client_cert
	)

Gets access point client cert file from configuration.

Since :: 3.0

Remarks:: You must release client_cert using free().

Parameters:

[in]	config	The access point configuration handle
[out]	client_cert	The certification authority(CA) certificates file of access point

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter

int wifi_manager_config_get_eap_identity	(	wifi_manager_config_h	config,
		char **	identity
	)

Gets access point identity from configuration.

Since :: 3.0

Remarks:: You must release identity using free().

Parameters:

[in]	config	The access point configuration handle
[out]	identity	The identity of access point

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter

int wifi_manager_config_get_eap_private_key_file	(	wifi_manager_config_h	config,
		char **	file
	)

Gets the private key file of EAP.

Since :: 5.0

Remarks:: This function is valid only if the EAP type is WIFI_MANAGER_EAP_TYPE_TLS. You must release file using free().

Parameters:

[in]	config	The access point configuration handle
[out]	file	The file path of private key

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_config_get_eap_subject_match	(	wifi_manager_config_h	config,
		char **	subject_match
	)

Gets access point subject match from configuration.

Since :: 3.0

Remarks:: You must release subject_match using free().

Parameters:

[in]	config	The access point configuration handle
[out]	subject_match	The subject match of access point

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter

int wifi_manager_config_get_eap_type	(	wifi_manager_config_h	config,
		wifi_manager_eap_type_e *	eap_type
	)

Gets access point EAP type from configuration.

Since :: 3.0

Parameters:

[in]	config	The access point configuration handle
[out]	eap_type	The EAP type of access point

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter

int wifi_manager_config_get_gateway_address	(	wifi_manager_config_h	config,
		wifi_manager_address_family_e	address_family,
		char **	gateway_address
	)

Gets access point gateway address from configuration.

Since :: 5.0

Remarks:: You must release gateway_address using free().

Parameters:

[in]	config	The access point configuration handle
[in]	address_family	The address family
[out]	gateway_address	The gateway address; this value is for default address

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_MANAGER_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED	Address family not supported
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_config_get_hidden_ap_property	(	wifi_manager_config_h	config,
		bool *	is_hidden
	)

Gets the hidden property of access point from the configuration.

Since :: 3.0

Parameters:

[in]	config	The access point configuration handle
[out]	is_hidden	The hidden property of access point

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_config_get_ip_address	(	wifi_manager_config_h	config,
		wifi_manager_address_family_e	address_family,
		char **	ip_address
	)

Gets access point IP address from configuration.

Since :: 5.0

Remarks:: You must release ip_address using free().

Parameters:

[in]	config	The access point configuration handle
[in]	address_family	The address family
[out]	ip_address	The IP address; this value is for default address

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_MANAGER_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED	Address family not supported
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_config_get_ip_config_type	(	wifi_manager_config_h	config,
		wifi_manager_address_family_e	address_family,
		wifi_manager_ip_config_type_e *	type
	)

Gets access point IP config type from configuration.

Since :: 5.0

Parameters:

[in]	config	The access point configuration handle
[in]	address_family	The address family
[out]	type	The type of IP configuration

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED	Address family not supported
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_config_get_name	(	wifi_manager_config_h	config,
		char **	name
	)

Gets the name of access point from configuration.

Since :: 3.0

Remarks:: You must release name using free().

Parameters:

[in]	config	The access point configuration handle
[out]	name	The name of access point

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_config_get_prefix_length	(	wifi_manager_config_h	config,
		wifi_manager_address_family_e	address_family,
		int *	prefix_len
	)

Gets the network prefix length from configuration.

Since :: 5.0

Parameters:

[in]	config	The access point configuration handle
[in]	address_family	The address family
[out]	prefix_len	The network prefix length. In case of IPv4, it means netmask length (also called a prefix, e.g. 8, 16, 24, 32)

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_MANAGER_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED	Address family not supported
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_config_get_proxy_address	(	wifi_manager_config_h	config,
		wifi_manager_address_family_e *	address_family,
		char **	proxy_address
	)

Gets the proxy address of access point from configuration.

Since :: 3.0

Remarks:: You must release proxy_address using free().

Parameters:

[in]	config	The access point configuration handle
[out]	address_family	The address family
[out]	proxy_address	The proxy address

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_config_get_security_type	(	wifi_manager_config_h	config,
		wifi_manager_security_type_e *	security_type
	)

Gets the security type of access point from configuration.

Since :: 3.0

Parameters:

[in]	config	The access point configuration handle
[out]	security_type	The security type of access point

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_config_get_subnet_mask	(	wifi_manager_config_h	config,
		wifi_manager_address_family_e	address_family,
		char **	subnet_mask
	)

Gets access point subnet mask from configuration.

Since :: 5.0

Remarks:: You must release subnet_mask using free().

Parameters:

[in]	config	The access point configuration handle
[in]	address_family	The address family
[out]	subnet_mask	The subnet mask

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_MANAGER_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED	Address family not supported
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_config_remove	(	wifi_manager_h	wifi,
		wifi_manager_config_h	config
	)

Removes Wi-Fi configuration of access point.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/network.profile

Parameters:

[in]	wifi	The Wi-Fi handle
[in]	config	The access point configuration handle

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

See also:: wifi_manager_config_create(); wifi_manager_config_foreach_configuration()

int wifi_manager_config_save	(	wifi_manager_h	wifi,
		wifi_manager_config_h	config
	)

Saves Wi-Fi configuration of access point.

When a configuration 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 configuration is updated.

Since :: 3.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/network.profile

Parameters:

[in]	wifi	The Wi-Fi handle
[in]	config	The access point configuration handle

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

See also:: wifi_manager_config_create()

int wifi_manager_config_set_dns_address	(	wifi_manager_config_h	config,
		int	order,
		wifi_manager_address_family_e	address_family,
		const char *	dns_address
	)

Sets access point dns address to configuration.

Since :: 5.0

Parameters:

[in]	config	The access point configuration 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.

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED	Not supported address family
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

See also:: wifi_manager_config_save()

int wifi_manager_config_set_dns_config_type	(	wifi_manager_config_h	config,
		wifi_manager_address_family_e	address_family,
		wifi_manager_dns_config_type_e	type
	)

Sets access point dns config type to configuration.

Since :: 5.0

Parameters:

[in]	config	The access point configuration handle
[in]	address_family	The address family
[in]	type	The type of DNS configuration

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED	Not supported address family
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

See also:: wifi_manager_config_save()

int wifi_manager_config_set_eap_anonymous_identity	(	wifi_manager_config_h	config,
		const char *	anonymous_identity
	)

Sets access point anonymous identity to configuration.

Since :: 3.0

Parameters:

[in]	config	The access point configuration handle
[in]	anonymous_identity	The anonymous identity

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied

See also:: wifi_manager_config_save()

int wifi_manager_config_set_eap_auth_type	(	wifi_manager_config_h	config,
		wifi_manager_eap_auth_type_e	eap_auth_type
	)

Sets access point EAP auth type to configuration.

Since :: 3.0

Parameters:

[in]	config	The access point configuration handle
[in]	eap_auth_type	The EAP auth type

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied

See also:: wifi_manager_config_save()

int wifi_manager_config_set_eap_ca_cert_file	(	wifi_manager_config_h	config,
		const char *	ca_cert
	)

Sets access point cacert file to configuration.

Since :: 3.0

Remarks:: The mediastorage privilege http://tizen.org/privilege/mediastorage is needed
if ca_cert is relevant to media storage.
The externalstorage privilege http://tizen.org/privilege/externalstorage is needed
if ca_cert is relevant to external storage.

Parameters:

[in]	config	The access point configuration handle
[in]	ca_cert	The certification authority(CA) certificates file of access point

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied

See also:: wifi_manager_config_save()

int wifi_manager_config_set_eap_client_cert_file	(	wifi_manager_config_h	config,
		const char *	private_key,
		const char *	client_cert
	)

Sets access point client cert file to configuration.

Since :: 3.0

Parameters:

[in]	config	The access point configuration handle
[in]	private_key	The private key file
[in]	client_cert	The certification authority(CA) certificates file of access point

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied

See also:: wifi_manager_config_save()

int wifi_manager_config_set_eap_identity	(	wifi_manager_config_h	config,
		const char *	identity
	)

Sets access point identity to configuration.

Since :: 3.0

Parameters:

[in]	config	The access point configuration handle
[in]	identity	The identity

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied

See also:: wifi_manager_config_save()

int wifi_manager_config_set_eap_private_key_info	(	wifi_manager_config_h	config,
		const char *	file,
		const char *	password
	)

Sets the private key information of EAP.

Since :: 5.0

Remarks:: This function is valid only if the EAP type is WIFI_MANAGER_EAP_TYPE_TLS.

Parameters:

[in]	config	The access point configuration handle
[in]	file	The file path of private key
[in]	password	The password

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

See also:: wifi_manager_config_save()

int wifi_manager_config_set_eap_subject_match	(	wifi_manager_config_h	config,
		const char *	subject_match
	)

Sets access point subject match to configuration.

Since :: 3.0

Parameters:

[in]	config	The access point configuration handle
[in]	subject_match	The subject match

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: wifi_manager_config_save()

int wifi_manager_config_set_eap_type	(	wifi_manager_config_h	config,
		wifi_manager_eap_type_e	eap_type
	)

Sets access point EAP type to configuration.

Since :: 3.0

Parameters:

[in]	config	The access point configuration handle
[in]	eap_type	The EAP type

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission Denied

See also:: wifi_manager_config_save()

int wifi_manager_config_set_gateway_address	(	wifi_manager_config_h	config,
		wifi_manager_address_family_e	address_family,
		const char *	gateway_address
	)

Sets access point gateway address to configuration.

Since :: 5.0

Parameters:

[in]	config	The access point configuration 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.

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED	Not supported address family
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

See also:: wifi_manager_config_save()

int wifi_manager_config_set_hidden_ap_property	(	wifi_manager_config_h	config,
		bool	is_hidden
	)

Sets the hidden property of access point from the configuration.

Since :: 3.0

Parameters:

[in]	config	The access point configuration handle
[in]	is_hidden	The new value of the hidden property

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission denied
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

See also:: wifi_manager_config_save()

int wifi_manager_config_set_ip_address	(	wifi_manager_config_h	config,
		wifi_manager_address_family_e	address_family,
		const char *	ip_address
	)

Sets access point IP address to configuration.

Since :: 5.0

Parameters:

[in]	config	The access point configuration 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_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED	Not supported address family
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

See also:: wifi_manager_config_save()

int wifi_manager_config_set_ip_config_type	(	wifi_manager_config_h	config,
		wifi_manager_address_family_e	address_family,
		wifi_manager_ip_config_type_e	type
	)

Sets access point IP config type to configuration.

Since :: 5.0

Parameters:

[in]	config	The access point configuration handle
[in]	address_family	The address family
[in]	type	The type of IP configuration

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED	Not supported address family
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

See also:: wifi_manager_config_save()

int wifi_manager_config_set_prefix_length	(	wifi_manager_config_h	config,
		wifi_manager_address_family_e	address_family,
		int	prefix_len
	)

Sets the network prefix length to configuration.

Since :: 5.0

Parameters:

[in]	config	The access point configuration handle
[in]	address_family	The address family
[in]	prefix_len	The network prefix length. In case of IPv4, it means netmask length (also called a prefix, e.g. 8, 16, 24, 32)

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED	Not supported address family
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

See also:: wifi_manager_config_save()

int wifi_manager_config_set_proxy_address	(	wifi_manager_config_h	config,
		wifi_manager_address_family_e	address_family,
		const char *	proxy_address
	)

Sets access point proxy address configuration.

Since :: 3.0

Parameters:

[in]	config	The access point configuration handle
[in]	address_family	The address family
[in]	proxy_address	The proxy address

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_PERMISSION_DENIED	Permission denied
WIFI_MANAGER_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED	Not supported address family
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

See also:: wifi_manager_config_save()

int wifi_manager_config_set_subnet_mask	(	wifi_manager_config_h	config,
		wifi_manager_address_family_e	address_family,
		const char *	subnet_mask
	)

Sets access point subnet mask to configuration.

Since :: 5.0

Parameters:

[in]	config	The access point configuration 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_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_NOT_INITIALIZED	Not initialized
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED	Not supported address family
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

See also:: wifi_manager_config_save()

Required Header

Overview

Related Features

Functions

Typedefs

Typedef Documentation

Function Documentation