|
Tizen Native API
10.0
|
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. | |
| int | wifi_manager_config_get_frequency (wifi_manager_config_h config, int *frequency) |
| Gets access point frequency from configuration. | |
| int | wifi_manager_config_set_frequency (wifi_manager_config_h config, int frequency) |
| Sets access point frequency 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.
This callback function is used in conjunction with `wifi_manager_config_foreach_configuration()` to iterate through all saved access point configurations.
- 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:
trueto continue with the next iteration of the loop, otherwisefalseto break out of the loop
- Precondition:
- wifi_manager_config_foreach_configuration() will invoke this callback.
Function Documentation
| int wifi_manager_config_clone | ( | wifi_manager_config_h | origin, |
| wifi_manager_config_h * | cloned_config | ||
| ) |
Clones the access point configuration handle.
This function creates a copy of the given access point configuration handle. The new handle has the same properties as the original 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.
This function creates a new access point configuration handle with the provided parameters. The handle can be used to save or update the access point configuration.
- 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.
This function destroys the access point configuration handle and releases all its associated resources. After calling this function, the handle is no longer valid.
- 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
| 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.
This function retrieves all access point configurations stored in the system. Each access point configuration is represented by a handle, which can be used to get detailed information about the 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.
This function retrieves the DNS address set for the given access point configuration. The DNS address is used to resolve domain names to IP addresses during the network communication process.
- Since :
- 5.0
- Remarks:
- The allowance of DNS address is
2.Youmust 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.
This function retrieves the DNS configuration type set for the given access point configuration. The DNS configuration type specifies how the DNS addresses are configured for the access point.
- 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.
This function retrieves the anonymous identity set for the given access point configuration. The anonymous identity is used during the authentication process to identify the client anonymously when connecting to the access point.
- 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.
This function retrieves the EAP authentication type set for the given access point configuration. The EAP authentication type specifies the method used to authenticate the client when connecting to the access point.
- 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.
This function retrieves the CA certificate file path set for the given access point configuration. The CA certificate file contains the trusted root certificates used to verify the server's certificate during the authentication process.
- 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.
This function retrieves the client certificate file path set for the given access point configuration. The client certificate file is used for EAP authentication to establish a secure connection with the access point.
- 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.
This function retrieves the EAP identity set for the given access point configuration. The EAP identity is used during the authentication process to identify the client when connecting to the access point.
- 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.
This function retrieves the file path of the private key used for EAP-TLS authentication. This function is only valid if the EAP type is set to WIFI_MANAGER_EAP_TYPE_TLS.
- 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.
This function retrieves the EAP subject match set for the given access point configuration. The EAP subject match specifies which certificates to trust when connecting to the access point.
- 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.
This function retrieves the EAP type set for the given access point configuration. The EAP type specifies the EAP protocol used to authenticate the client when connecting to the access point.
- 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_frequency | ( | wifi_manager_config_h | config, |
| int * | frequency | ||
| ) |
Gets access point frequency from configuration.
This function gets the frequency band (MHz) for the given access point configuration. The frequency band indicates the radio frequency used by the access point.
- Since :
- 10.0
- Parameters:
-
[in] config The access point configuration handle [out] frequency The frequency of access point
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
WIFI_MANAGER_ERROR_NONE Successful WIFI_MANAGER_ERROR_INVALID_PARAMETER Invalid parameter WIFI_MANAGER_ERROR_NOT_SUPPORTED Not supported
| 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.
This function retrieves the gateway address set for the given access point configuration. The gateway address is used as the default route for the network traffic.
- 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.
This function retrieves the hidden property of the access point set in the given access point configuration. The hidden property indicates whether the access point is hidden or not.
- 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.
This function retrieves the IP address set for the given access point configuration. The IP address is used as the local address for the device when connected to the access point.
- 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.
This function retrieves the IP configuration type set for the given access point configuration. The IP configuration type determines how the IP address and related information (e.g., subnet mask, gateway) are obtained.
- 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.
This function retrieves the name set for the given access point configuration. The name is a user-friendly identifier for the access point.
- 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.
This function retrieves the network prefix length set for the given access point configuration. The network prefix length specifies the number of leading bits in the IP address that are used to determine the network portion of the address.
- 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.
This function retrieves the proxy address set for the given access point configuration. The proxy address is used to route traffic through a proxy server.
- 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.
This function retrieves the security type set for the given access point configuration. The security type determines the type of security mechanism used to protect the wireless network.
- 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.
This function retrieves the subnet mask set for the given access point configuration. The subnet mask is used to specify the network portion of an IP address.
- 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.
This function deletes the specified access point configuration from the system. After this function is called, the access point configuration will no longer be available.
- 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
| 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.
This function sets the DNS address for the given access point configuration. The DNS address is used to resolve domain names to IP addresses during the network communication process.
- 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.
This function sets the DNS configuration type for the given access point configuration. The DNS configuration type specifies how the DNS addresses are configured for the access point.
- 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.
This function sets the anonymous identity for the given access point configuration. The anonymous identity is used during the authentication process to identify the client anonymously when connecting to the access point.
- 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.
This function sets the EAP authentication type for the given access point configuration. The EAP authentication type specifies the method used to authenticate the client when connecting to the access point.
- 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.
This function sets the CA certificate file required for EAP authentication. The CA certificate file contains the trusted root certificates used to verify the server's certificate during the authentication process.
- 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.
This function sets the client certificate and private key files required for EAP authentication. These files are used to establish a secure connection with the access point.
- 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.
This function sets the EAP identity for the given access point configuration. The EAP identity is used during the authentication process to identify the client when connecting to the access point.
- 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.
This function sets the private key information required for EAP-TLS authentication. It includes the file path of the private key and its corresponding password. This function is only valid if the EAP type is set to WIFI_MANAGER_EAP_TYPE_TLS.
- 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.
This function sets the EAP subject match for the given access point configuration. The EAP subject match is used to specify which certificates to trust when connecting to the access point.
- 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.
This function sets the EAP type for the given access point configuration. The EAP type specifies the EAP protocol used to authenticate the client when connecting to the access point.
- 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_frequency | ( | wifi_manager_config_h | config, |
| int | frequency | ||
| ) |
Sets access point frequency to configuration.
This function sets the frequency band (MHz) for the given access point configuration. The frequency band determines the radio frequency the access point will use.
- Since :
- 10.0
- Parameters:
-
[in] config The access point configuration handle [in] frequency The frequency of access point
- Returns:
- 0 on success, otherwise negative error value
- Return values:
-
WIFI_MANAGER_ERROR_NONE Successful 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_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.
This function sets the gateway address for the given access point configuration. The gateway address is used as the default route for the network traffic.
- 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.
This function sets the hidden property of the access point in the given access point configuration. The hidden property indicates whether the access point is hidden or not.
- 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.
This function sets the IP address for the given access point configuration. The IP address is used as the local address for the device when connected to the access point.
- 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.
This function sets the IP configuration type for the given access point configuration. The IP configuration type determines how the IP address and related information (e.g., subnet mask, gateway) are obtained.
- 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.
This function sets the network prefix length for the given access point configuration. The network prefix length specifies the number of leading bits in the IP address that are used to determine the network portion of the address.
- 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.
This function sets the proxy address for the given access point configuration. The proxy address is used to route traffic through a proxy server.
- 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.
This function sets the subnet mask for the given access point configuration. The subnet mask is used to specify the network portion of an IP address.
- 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()