wifi.h

/*
 * Copyright (c) 2000-2017 Samsung Electronics Co., Ltd All Rights Reserved
 *
 * PROPRIETARY/CONFIDENTIAL
 *
 * This software is the confidential and proprietary information of
 * SAMSUNG ELECTRONICS ("Confidential Information").
 * You shall not disclose such Confidential Information and shall
 * use it only in accordance with the terms of the license agreement
 * you entered into with SAMSUNG ELECTRONICS.
 * SAMSUNG make no representations or warranties about the suitability
 * of the software, either express or implied, including but not
 * limited to the implied warranties of merchantability, fitness for
 * a particular purpose, or non-infringement.
 * SAMSUNG shall not be liable for any damages suffered by licensee as
 * a result of using, modifying or distributing this software or its derivatives.
 */

#ifndef LIBMDM_MDM_WIFI_H
#define LIBMDM_MDM_WIFI_H

#include <stdbool.h>
#include "mdm_client_type.h"

typedef struct {
    char *dns1;      
    char *dns2;      
    char *gateway;   
    char *ipAddress; 
    char *netmask;   
} dhcp_info_t;

typedef struct {
    char *ssid;  
    char *value; 
    int   type;  
} wifi_info_t;

typedef struct {
    char *ssid;     
    char *filepath; 
    char *password; 
} wifi_private_key_info_t;

typedef enum {
    MDM_WIFI_EAP_TYPE_NONE = 0, 
    MDM_WIFI_EAP_TYPE_PEAP,     
    MDM_WIFI_EAP_TYPE_TLS,      
    MDM_WIFI_EAP_TYPE_TTLS,     
    MDM_WIFI_EAP_TYPE_SIM,      
    MDM_WIFI_EAP_TYPE_AKA,      
    MDM_WIFI_EAP_TYPE_NOT_EAP,  
    MDM_WIFI_EAP_TYPE_MAX
} mdm_wifi_eap_type_e;

typedef enum {
    SECURITY_LEVEL_NONE = 0, 
    SECURITY_LEVEL_OPEN,     
    SECURITY_LEVEL_WEP,      
    SECURITY_LEVEL_WPA_PSK,  
    SECURITY_LEVEL_WPA2_PSK, 
    SECURITY_LEVEL_EAP_PEAP, 
    SECURITY_LEVEL_EAP_TLS,  
    SECURITY_LEVEL_EAP_TTLS, 
    SECURITY_LEVEL_EAP_SIM,  
    SECURITY_LEVEL_EAP_AKA,  
    SECURITY_LEVEL_MAX
} mdm_wifi_sec_type_e;

typedef enum {
    MDM_WIFI_EAP_PHASE_2_AUTH_NONE = 0, 
    MDM_WIFI_EAP_PHASE_2_AUTH_PAP,      
    MDM_WIFI_EAP_PHASE_2_AUTH_MSCHAP,   
    MDM_WIFI_EAP_PHASE_2_AUTH_MSCHAPV2, 
    MDM_WIFI_EAP_PHASE_2_AUTH_GTC,      
    MDM_WIFI_EAP_PHASE_2_AUTH_MD5,      
    MDM_WIFI_EAP_PHASE_2_AUTH_MAX
} mdm_wifi_eap_phase_2_auth_e;

typedef struct mdm_wifi_open_sim_aka_data_s {
    int reserved; 
} mdm_wifi_open_sim_aka_data_t;

typedef struct mdm_wifi_wep_wpa_data_s {
    const char *password;
} mdm_wifi_wep_wpa_data_t;

typedef struct mdm_wifi_eap_peap_ttls_data_s {
    const char *                identity;           
    const char *                anonymous_identity; 
    const char *                password;           
    mdm_wifi_eap_phase_2_auth_e phase_2_auth;       
    const char *                ca_cert_file;       
    const char *                subject_match;      
} mdm_wifi_eap_peap_ttls_data_t;

typedef struct mdm_wifi_eap_tls_data_s {
    const char *identity;           
    const char *anonymous_identity; 
    const char *password;           
    const char *ca_cert_file;       
    const char *client_cert_file;   
    const char *private_key_file;   
    const char *subject_match;      
} mdm_wifi_eap_tls_data_t;

typedef struct mdm_wifi_ap_config_s {
    const char *        ssid; 
    mdm_wifi_sec_type_e type; 
    union {
        mdm_wifi_open_sim_aka_data_t  open;
        mdm_wifi_wep_wpa_data_t       wep;
        mdm_wifi_wep_wpa_data_t       wpa;
        mdm_wifi_eap_peap_ttls_data_t eap_peap;
        mdm_wifi_eap_peap_ttls_data_t eap_ttls;
        mdm_wifi_eap_tls_data_t       eap_tls;
        mdm_wifi_open_sim_aka_data_t  eap_sim;
        mdm_wifi_open_sim_aka_data_t  eap_aka;
    } security;
} mdm_wifi_ap_config_t;

/*
 * @brief Wi-Fi certificate level
 * @since_mdm 1.0.0
 * @since_tizen 2.3.1.5
 */
typedef enum {
    CERTIFICATE_SECURITY_LEVEL_NONE = 0, 
    CERTIFICATE_SECURITY_LEVEL_LOW,      
    CERTIFICATE_SECURITY_LEVEL_HIGH,     
    CERTIFICATE_SECURITY_LEVEL_MAX
} mdm_wifi_cert_level_e;

typedef struct {
    char *ssid;     
    int   sec_type; 
} mdm_wifi_configuration_t;

typedef enum {
    MDM_WIFI_ALLOWED                        = 0x0010,
    MDM_WIFI_BLOCKED_NETWORK_POLICY_CHANGED = 0x0020,
} mdm_wifi_status_t;

typedef enum {
    MDM_NOTI_TYPE_SETTING_USER_MODIFICATION = 0x0010, 
} wifi_tethering_status_t;

typedef enum {
    MDM_NOTI_ALLOWED    = 0x00, 
    MDM_NOTI_RESTRICTED = 0x01, 
} wifi_noti_t;

#ifdef __cplusplus
extern "C" {
#endif

mdm_result_t mdm_set_allow_wifi(mdm_status_t state);

mdm_status_t mdm_get_allow_wifi(void);

MDM_DEPRECATED_API mdm_data_t *mdm_get_wifi_ssid(void);

mdm_status_t mdm_is_wifi_hidden_ssid(void);

/*
 * @brief API to connect to a Wi-Fi network to be associated with.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * This will let the user to choose a Wi-Fi network from a system dialog
 * that contains all the available networks in the area.
 *
 * @code{.c}

    mdm_result_t ret = mdm_set_wifi_network();
    if(ret != MDM_RESULT_SUCCESS) {
          //Fail
    } else {
          //System dialog with available
          //networks will be displayed
    }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 */
mdm_result_t mdm_set_wifi_network(void);

MDM_DEPRECATED_API mdm_data_t *mdm_get_wifi_dhcpinfo(void);

/*
 * @brief API to set the link security level of the enterprise WLAN.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set the link security level of the enterprise WLAN.
 * The acceptable values are: "NONE" ,"WEP" ,"PSK" and "EAP-x", where x can be "PEAP", "LEAP", "TLS", "TTLS" and "FAST".
 *
 * @code{.c}

     mdm_result_t result = mdm_set_network_link_security();
     if (result == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }
 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[in] value  The security level for WLAN enterprise network.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on set network link security level success,
 * MDM_RESULT_FAIL on set network link security level failure.
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 */
mdm_result_t mdm_set_network_link_security(const char *ssid, mdm_wifi_sec_type_e value);

/*
 * @brief API to get the enterprise WLAN Link Security.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can get the enterprise WLAN Link Security.
 * The possible values are: "Open", "WEP", "WPA or WPA2 PSK""802.1x EAP-LEAP", "802.1x EAP-FAST",
 * "802.1x EAP-PEAP", "802.1x EAP-TTLS" and "802.1x EAP-TLS"
 *
 * @code{.c}

    mdm_wifi_sec_type_e type;
    mdm_result_t ret = mdm_get_network_link_security("CompanyAP", &type);
     if (ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }
 * @endcode
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[out] type  The security type for WLAN enterprise network.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on set network link security level success,
 * MDM_RESULT_FAIL on set network link security level failure.
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 */
mdm_result_t mdm_get_network_link_security(const char *ssid, mdm_wifi_sec_type_e *type);

/*
 * @brief API to set the enterprise WLAN EAP Network Identity (username).
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set the username (identity) for PEAP or LEAP security access for the enterprise WLAN network.
 *
 * @code{.c}

     mdm_result_t ret = mdm_set_network_identity_value(ssid, password);
     if (ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }
 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[in] value  The WLAN EAP identity value (username).
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on set network identity value success,
 * MDM_RESULT_FAIL on set network identity value failure.
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 */
mdm_result_t mdm_set_network_identity_value(const char *ssid, const char *value);

/*
 * @brief API to get the enterprise WLAN EAP Identity.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can get the enterprise WLAN EAP Identity (username).
 *
 * @code{.c}

     mdm_data_t *lp_data = mdm_get_network_identity_value(ssid);
     if (lp_data) {
        char *username = (char *)lp_data->data;
     } else {
        // Fail
     }
 * @endcode
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 *
 * @return #mdm_data_t * : The user name for the enterprise WLAN network if set, null if no user name set.
 *
 */
mdm_data_t *mdm_get_network_identity_value(const char *ssid);

/*
 * @brief API to set the enterprise WLAN EAP password.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set a password for PEAP or LEAP security access for the enterprise WLAN network.
 *
 * @code{.c}

     mdm_result_t ret = mdm_set_network_password(ssid, password);
     if (ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }
 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[in] value  The WLAN EAP identity value (password).
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on set network identity value success,
 * MDM_RESULT_FAIL on set network identity value failure.
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_get_network_password
 */
mdm_result_t mdm_set_network_password(const char *ssid, const char *value);

/*
 * @brief API to get the enterprise WLAN EAP password.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can get the enterprise WLAN Pre-Shared Key for WPA or WPA2 security access for the enterprise WLAN network.
 *
 * @code{.c}

     mdm_status_t status = mdm_get_network_password();
     if(status == MDM_TRUE) {
        // set
     } else if (status == MDM_FALSE) {
        // not set
     } else {
        // fail
     }

 * @endcode
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 *
 * @return #mdm_status_t : The current prevention status.
 *
 * @retval #MDM_TRUE Password set.
 * @retval #MDM_FALSE Password not set.
 *
 * @see mdm_set_network_password
 */
mdm_status_t mdm_get_network_password(const char *ssid);

/*
 * @brief API to set the enterprise WLAN WEP Key.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set an string value for WEP key.
 *
 * @code{.c}

     mdm_result_t ret = mdm_set_network_wep_key(ssid, key);
     if (ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }
 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[in] value  The WEP Key .
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on set WEP key value success, MDM_RESULT_FAIL on set WEP key value failure.
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_get_network_wep_key
 */
mdm_result_t mdm_set_network_wep_key(const char *ssid, const char *value);

/*
 * @brief API to get WEP Key.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set an string value for WEP key.
 *
 * @code{.c}

     mdm_status_t ret = mdm_get_network_wep_key(ssid, key);
     if (ret == MDM_TRUE) {
        // WEP key exists
     } else if(ret == MDM_FALSE) {
        // WEP key doesn't exist
     } else {
        // Fail
     }
 * @endcode
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 *
 * @return #mdm_status_t : Current status.
 *
 * @retval #MDM_TRUE WEP Key exists
 * @retval #MDM_FALSE No WEP Key set
 * @retval #MDM_STATUS_ERROR Get WEP key value failure
 *
 * @see mdm_set_network_wep_key
 */
mdm_status_t mdm_get_network_wep_key(const char *ssid);

/*
 * @brief API to set the enterprise WLAN EAP CA Certificate.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set the CA certificate for enterprise WLAN EAP configured on the device to be used on authentication with server.
 *
 * @code{.c}

     mdm_result_t ret = mdm_set_network_ca_certificate(ssid, key);
     if (ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }
 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[in] value  The WEP Key. Admin can get the certificates using mdm_get_installed_certificate_names(String)
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on set WEP key value success, MDM_RESULT_FAIL on set WEP key value failure.
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_get_network_ca_certificate
 */
mdm_result_t mdm_set_network_ca_certificate(const char *ssid, const char *value);

/*
 * @brief API to get the enterprise WLAN EAP Ca Certificate.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can get the enterprise WLAN EAP Ca Certificate configured on the device, used during authentication with server.
 *
 * @code{.c}

     mdm_data_t *lp_data = mdm_get_network_ca_certificate(ssid);

     if (lp_data) {
        //Success
        char *filepath = (char *)lp_data->data;
     } else {
        //Fail
     }
 * @endcode
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 *
 * @return #mdm_data_t * : The ca certificate if set, NULL if no WLAN ca certificate set.
 *
 * @see mdm_set_network_ca_certificate
 */
mdm_data_t *mdm_get_network_ca_certificate(const char *ssid);

/*
 * @brief API to set the enterprise WLAN EAP Client Certificate.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set the Client Certificate for enterprise WLAN EAP configured on the device
 * to be used on authentication with server.
 *
 * @code{.c}
     mdm_data_t *lp_data = mdm_get_installed_certificate_names(type);
     char *cert_name = NULL;
     if(lp_data) {
        GList *current = g_list_first(lp_data->data);
        if(current && current->data) {
            cert_name = (char *)current->data;
        }
     }

     mdm_result_t ret = mdm_set_network_client_certificate(ssid, cert_name);
     if (ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }
     mdm_free_data(lp_data);
 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[in] value  The WLAN EAP Client certificate name stored on cert manager.
 * Admin can get the certificates using #mdm_get_installed_certificate_names
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on set network client certificate success, MDM_RESULT_FALSE on set network client certificate failure.
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_get_network_client_certificate
 */
mdm_result_t mdm_set_network_client_certificate(const char *ssid, const char *value);

/*
 * @brief API to get the enterprise WLAN Client Certificate.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can get the enterprise WLAN Client Certificate configured on the device, used during authentication with server.
 *
 * @code{.c}

     mdm_data_t *lp_data = mdm_get_network_client_certificate(ssid);

     if (lp_data) {
        //Success
        char *filepath = (char *)lp_data->data;
     } else {
        //Fail
     }
 * @endcode
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 *
 * @return #mdm_data_t * : The client certificate if set, NULL if no WLAN client certificate set.
 *
 * @see mdm_set_network_client_certificate
 */
mdm_data_t *mdm_get_network_client_certificate(const char *ssid);

/*
 * @brief API to set the enterprise WLAN User Private Key credential.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set the Private Key credential for enterprise WLAN EAP configured on the device to be used on authentication with server.
 * The private key is provisioned along with each client certificate, so the caller should set the same name used for mdm_set_network_client_certificate.
 *
 * @code{.c}


     mdm_result_t ret = mdm_set_network_private_key(ssid, filepath, password);
     if (ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }
     mdm_free_data(lp_data);
 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[in] filepath  The file path of private key
 * @param[in] password  The password
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on set network client certificate success,
 * MDM_RESULT_FALSE on set network client certificate failure.
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_get_network_private_key
 */
mdm_result_t mdm_set_network_private_key(const char *ssid, const char *filepath, const char *password);

/*
 * @brief API to get the enterprise WLAN user private key credential.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can get the enterprise WLAN user private key credential for enterprise WLAN EAP configured on the device,
 * used on authentication with server.
 *
 * @code{.c}
     mdm_data_t *lp_data = mdm_get_network_private_key(ssid);
     if(lp_data && lp_data->data) {
        char *key = (char *)lp_data->data;
     }

     mdm_free_data(lp_data);
 * @endcode
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 *
 * @return #mdm_data_t * : The private key filepath if set, NULL if no private key set
 *
 * @see mdm_set_network_private_key
 */
mdm_data_t *mdm_get_network_private_key(const char *ssid);

/*
 * @brief API to get the enterprise WLAN EAP type.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can get the enterprise WLAN EAP type (TLS, TTLS, FAST..).
 *
 * @code{.c}

     mdm_wifi_eap_type_e type;
     mdm_result_t ret = mdm_get_network_eap_type(ssid, &type);

 * @endcode
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[out] type The WLAN EAP type (PEAP, LEAP, TLS, TTLS, FAST) if set, MDM_WIFI_EAP_TYPE_NONE if no EAP type set.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 */
mdm_result_t mdm_get_network_eap_type(const char *ssid, mdm_wifi_eap_type_e *type);

MDM_DEPRECATED_API mdm_status_t mdm_is_network_secure(const char *ssid);

/*
 * @brief API to set the default Gateway on a enterprise network in case the DHCP is turned off.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set the default Gateway in case the connection settings are set to use a static IP to connect to the network.
 * In case one tries to call this function for a network with a dynamic configuration (for example, DHCP is on), an error will be
 * returned. To check, if network is static or dynamic call mdm_get_network_dhcp_enabled().
 *
 * @code{.c}

     mdm_result_t ret = mdm_set_network_gateway(ssid, ip);
     if(ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[in] value The Gateway address.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on set default gateway success, MDM_RESULT_FAIL on set default gateway failure
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_get_network_gateway
 */
mdm_result_t mdm_set_network_gateway(const char *ssid, const char *value);

/*
 * @brief API to get the default Gateway on a enterprise network in case the DHCP is turned off.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can get the default Gateway in case the connection settings are set to use a static IP to connect to the network.
 *
 * @code{.c}

     mdm_data_t *lp_data = mdm_get_network_gateway(ssid);
     if(lp_data && lp_data->ret == MDM_RESULT_SUCCESS) {
        char *ipAddr = (char *)lp_data->data;
     } else {
        //Fail
     }

 * @endcode
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 *
 * @return #mdm_data_t * : The default gateway, if it has been previously configured; NULL, if it has not been previously configured.
 *
 * @see mdm_set_network_gateway
 */
mdm_data_t *mdm_get_network_gateway(const char *ssid);

/*
 * @brief API to set the default IP on the enterprise network in case the DHCP is turned off.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set the default IP in case the connection settings are set to use a static IP to connect to the network.
 * In case one tries to call this function for a network with a dynamic configuration
 * (for example, DHCP is on), an error will be
 * returned. To check, if network is static or dynamic call mdm_get_network_dhcp_enabled().
 * @code{.c}

     mdm_result_t ret = mdm_set_network_ip(ssid, ip);
     if(ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[in] value The IP address.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on set default IP success, MDM_RESULT_FAIL on set default IP failure
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_get_network_ip
 */
mdm_result_t mdm_set_network_ip(const char *ssid, const char *value);

/*
 * @brief API to get the default IP on a enterprise network in case the DHCP is turned off.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can get the default IP in case the connection settings are set to use a static IP to connect to the network.
 *
 * @code{.c}

     mdm_data_t *lp_data = mdm_get_network_ip(ssid);
     if(lp_data) {
        char *ipAddr = (char *)lp_data->data;
     } else {
        //Fail
     }

 * @endcode
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 *
 * @return #mdm_data_t * : The default IP address, if it has been previously configured; NULL, if it has not been previously configured.
 *
 * @see mdm_set_network_ip
 */
mdm_data_t *mdm_get_network_ip(const char *ssid);

/*
 * @brief API to set the default Primary DNS on a enterprise network in case the DHCP is turned off.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set the default Primary DNS in case the connection settings are set to use a static IP
 * to connect to the network.
 * In case one tries to call this function for a network with a dynamic configuration
 * (for example, DHCP is on), an error will be
 * returned. To check, if network is static or dynamic call mdm_get_network_dhcp_enabled().
 *
 * @code{.c}

     mdm_result_t ret = mdm_set_network_primary_dns(ssid, ip);
     if(ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[in] value The primary dns address.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on set primary dns success, MDM_RESULT_FAIL on set primary dns failure
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_get_network_primary_dns
 */
mdm_result_t mdm_set_network_primary_dns(const char *ssid, const char *value);

/*
 * @brief API to set the primary DNS on a enterprise network in case the DHCP is turned off.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set the primary DNS in case the connection settings are set to use a static IP to connect to the network.
 *
 * @code{.c}

     mdm_data_t *lp_data = mdm_get_network_primary_dns(ssid);
     if(lp_data) {
        char *ipAddr = (char *)lp_data->data;
     } else {
        //Fail
     }

 * @endcode
 *
 * @param[in] ssid The SSID of a Enterprise WLAN Network.
 *
 * @return #mdm_data_t * : The primary DNS, if it has been previously configured; null, if it has not been previously configured.
 *
 * @see mdm_set_network_primary_dns
 */
mdm_data_t *mdm_get_network_primary_dns(const char *ssid);

/*
 * @brief API to set the secondary DNS on a enterprise network in case the DHCP is turned off.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set the secondary DNS in case the connection settings are set to use a static IP to connect to the network.
 * In case one tries to call this function for a network with a dynamic configuration
 * (for example, DHCP is on), an error will be
 * returned. To check, if network is static or dynamic call mdm_get_network_dhcp_enabled().
 *
 * @code{.c}

     mdm_result_t ret = mdm_set_network_secondary_dns(ssid, ip);
     if(ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[in] value The secondary DNS address.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on set secondary DNS success, MDM_RESULT_FAIL on set secondary DNS failure
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_get_network_secondary_dns
 */
mdm_result_t mdm_set_network_secondary_dns(const char *ssid, const char *value);

/*
 * @brief API to set the secondary DNS on a enterprise network in case the DHCP is turned off.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set the secondary DNS in case the connection settings are set to use a static IP to connect to the network.
 *
 * @code{.c}

     mdm_data_t *lp_data = mdm_get_network_secondary_dns(ssid);
     if(lp_data) {
        char *ipAddr = (char *)lp_data->data;
     } else {
        //Fail
     }

 * @endcode
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 *
 * @return #mdm_data_t * : The secondary DNS, if it has been previously configured; null,
 * if it has not been previously configured.
 *
 * @see mdm_set_network_secondary_dns
 */
mdm_data_t *mdm_get_network_secondary_dns(const char *ssid);

/*
 * @brief API to set the default Subnet Mask on a enterprise network in case the DHCP is turned off.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set the default default Subnet Mask in case the connection settings are set to
 * use a static IP to connect to the network.
 * In case one tries to call this function for a network with a dynamic configuration
 * (for example, DHCP is on), an error is
 * returned. To check, if network is static or dynamic call mdm_get_network_dhcp_enabled().
 *
 * @code{.c}

     mdm_result_t ret = mdm_set_network_subnet_mask(ssid, ip);
     if(ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[in] value The subnet Mask.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on set subnet mask success, MDM_RESULT_FAIL on set subnet mask failure
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_get_network_subnet_mask
 */
mdm_result_t mdm_set_network_subnet_mask(const char *ssid, const char *value);

/*
 * @brief API to get the default Subnet Mask on a enterprise network in case the DHCP is turned off.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can get the default Subnet Mask in case the connection settings are set to use a static IP to connect to the network.
 *
 * @code{.c}

     mdm_data_t *lp_data = mdm_get_network_subnet_mask(ssid);
     if(lp_data) {
        char *ipAddr = (char *)lp_data->data;
     } else {
        //Fail
     }

 * @endcode
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 *
 * @return #mdm_data_t * : The subnet mask if it has been previously configured; null,
 * if it has not been previously configured;
 *
 * @see mdm_set_network_subnet_mask
 */
mdm_data_t *mdm_get_network_subnet_mask(const char *ssid);

mdm_result_t mdm_get_blocked_networks(GList **blockedlist, GList **exceptlist);


mdm_result_t mdm_set_allow_user_policy_changes(mdm_status_t enable);

mdm_status_t mdm_get_allow_user_policy_changes(void);

mdm_result_t mdm_set_minimum_required_security(mdm_wifi_sec_type_e secType);

mdm_wifi_sec_type_e mdm_get_minimum_required_security(void);

/*
 * @brief API to set a minimum certificate security level Wi-Fi AP.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set a minimum certificate security level one of below:
 *   #CERTIFICATE_SECURITY_LEVEL_LOW
 *   #CERTIFICATE_SECURITY_LEVEL_HIGH
 *
 * @code{.c}

     mdm_result_t ret = mdm_set_tls_certificate_security_level(CERTIFICATE_SECURITY_LEVEL_LOW);
     if(ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @param[in] level  The minimum required certificate level.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_get_tls_certificate_security_level
 */
mdm_result_t mdm_set_tls_certificate_security_level(mdm_wifi_cert_level_e level);

/*
 * @brief API to get a Wi-Fi profile from the admin.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can get current minimum security level to connect to a Wi-Fi AP.
 * The possible values, from the lowest to highest, are:
 *   #CERTIFICATE_SECURITY_LEVEL_LOW,
 *   #CERTIFICATE_SECURITY_LEVEL_HIGH.
 *
 * @code{.c}

     mdm_wifi_sec_type_e secType = mdm_get_tls_certificate_security_level();

 * @endcode
 *
 * @return #mdm_wifi_sec_type_e : Representing the network security level if set, CERTIFICATE_SECURITY_LEVEL_NONE if certificate security level not set.
 *
 * @retval #CERTIFICATE_SECURITY_LEVEL_NONE Wi-Fi certificate level none
 * @retval #CERTIFICATE_SECURITY_LEVEL_LOW General Wi-Fi certificate level low
 * @retval #CERTIFICATE_SECURITY_LEVEL_HIGH Wi-Fi certificate level high
 *
 * @see mdm_set_tls_certificate_security_level
 */
mdm_wifi_cert_level_e mdm_get_tls_certificate_security_level(void);

mdm_result_t mdm_set_password_hidden(mdm_status_t passHidden);

mdm_status_t mdm_get_password_hidden(void);

/*
 * @brief API to set the enterprise WLAN Pre-Shared Key for WPA/WPA2 access.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set a Pre-Shared Key for WPA or WPA2 security access for the enterprise WLAN network.
 * The Pre-Shared Key can be a 256-bit Hex or a string value. PSK is a shared secret which was
 * previously shared between the two parties using some secure channel before it needs to be used.
 *
 * @code{.c}

     mdm_result_t ret = mdm_set_network_psk(("Company Wi-Fi",
 "f348e73d08e4812e51e40ed04b400f38cfe07a7a4d8d12745327a4a3d51cf854");
     if(ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[in] psk  The Pre-Shared Key.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on set network PSK success, MDM_RESULT_FAIL on set network PSK failure.
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_get_network_psk
 */
mdm_result_t mdm_set_network_psk(const char *ssid, const char *psk);

/*
 * @brief API to get the enterprise WLAN Pre-Shared Key.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can get the enterprise WLAN Pre-Shared Key for WPA or WPA2 security access for the enterprise WLAN network.
 *
 * @code{.c}

     mdm_status_t ret = mdm_get_network_psk();
     if(ret == MDM_TRUE) {
        // hidden
     } else if (ret == MDM_FALSE) {
        // not hidden
     } else {
        // fail
     }

 * @endcode
 *
 * @return #mdm_status_t : Whether Pre-Shared Key is set
 *
 * @retval #MDM_TRUE Pre-Shared Key set
 * @retval #MDM_FALSE No Pre-Shared Key set
 * @retval #MDM_STATUS_ERROR Error
 *
 * @see mdm_set_network_psk
 */
mdm_status_t mdm_get_network_psk(const char *ssid);

/*
 * @brief API to set the the enterprise WLAN EAP Anonymous Identity.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set the the enterprise WLAN EAP Anonymous Identity. This key is only relevant to TTLS, PEAP, and EAP-FAST.
 * This allows the user to hide his or her identity. The user's actual name appears only inside the encrypted tunnel.
 * For example, it could be set to "anonymous" or "anon", or "anon@mycompany.net".
 *
 * @code{.c}

     mdm_result_t ret = mdm_set_network_anonymous_id_value(ssid, value);
     if(ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }

 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[in] value  The WLAN EAP Anonymous Identity value.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on set network anonymous Identity value success,
 * MDM_RESULT_FAIL on set network anonymous Identity value failure.
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_get_network_anonymous_id_value
 */
mdm_result_t mdm_set_network_anonymous_id_value(const char *ssid, const char *value);

/*
 * @brief API to get the enterprise WLAN EAP Anonymous Identity.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can set the the enterprise WLAN EAP Anonymous Identity. This key is only relevant to TTLS, PEAP, and EAP-FAST.
 * This allows the user to hide his or her identity. The user's actual name appears only inside the encrypted tunnel.
 * For example, it could be set to "anonymous" or "anon", or "anon@mycompany.net".
 *
 * @code{.c}
     mdm_data_t *lp_data = mdm_get_network_anonymous_id_value(ssid);
     if(lp_data) {
        char *value = (char *)lp_data->data;
     } else {
        //Fail
     }
 * @endcode
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 *
 * @return #mdm_data_t * : The network anonymous id value if set, null if network anonymous id value not set
 *
 * @see mdm_set_network_anonymous_id_value
 */
mdm_data_t *mdm_get_network_anonymous_id_value(const char *ssid);


/*
 * @brief API to enable use of DHCP on a enterprise network.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can enable use of DHCP on a enterprise network.
 *
 * @code{.c}
     mdm_result_t ret = mdm_set_network_dhcp_enabled(ssid, MDM_DISABLED);
     if(ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }
 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 * @param[in] enable  MDM_ENABLED to enable connection using DHCP, MDM_DISABLED to disable it
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on set network DHCP enabled success, MDM_RESULT_FAIL on set network DHCP enabled failure.
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 * @see mdm_get_network_dhcp_enabled
 */
mdm_result_t mdm_set_network_dhcp_enabled(const char *ssid, mdm_status_t enable);

/*
 * @brief API to check the use of DHCP on a enterprise network.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can check the use of DHCP on a enterprise network or it is restricted to static IP.
 *
 * @code{.c}
     mdm_status_t ret = mdm_get_network_dhcp_enabled(ssid);
     if(ret == MDM_ENABLED) {
        // Enabled
     } else if(ret == MDM_DISABLED) {
        // Disabled
     } else {
        // Fail
     }
 * @endcode
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 *
 * @return #mdm_status_t : Whether DHCP is enabled.
 *
 * @retval #MDM_ENABLED DHCP is enabled
 * @retval #MDM_DISABLED Static IP is enabled
 * @retval #MDM_STATUS_ERROR Error
 *
 * @see mdm_set_network_dhcp_enabled
 */
mdm_status_t mdm_get_network_dhcp_enabled(const char *ssid);

mdm_status_t mdm_is_network_blocked(const char *ssid);

/*
 * @brief API to remove the enterprise WLAN configuration.
 *
 * @since_mdm 1.0.0
 *
 * @since_tizen 2.3.2.5
 *
 * @feature %http://developer.samsung.com/tizen/feature/mdm
 *
 * @par Usage:
 *
 * Admin can remove an enterprise WLAN configuration. The network name is removed from the APs list,
 * so that the user does not need to remove it manually.
 *
 * @code{.c}
     mdm_result_t ret = mdm_remove_network_configuration(ssid);
     if(ret == MDM_RESULT_SUCCESS) {
        //Success
     } else {
        //Fail
     }
 * @endcode
 *
 * @privlevel public
 * @privilege %http://developer.samsung.com/tizen/privilege/mdm.wifi
 *
 * @param[in] ssid  The SSID of a Enterprise WLAN Network.
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on removal success, MDM_RESULT_FAIL on removal failure.
 *
 * @retval #MDM_RESULT_SUCCESS Successful
 * @retval #MDM_RESULT_FAIL General failure
 * @retval #MDM_RESULT_NOT_SUPPORTED Not supported
 * @retval #MDM_RESULT_INVALID_PARAM Invalid parameter
 * @retval #MDM_RESULT_ACCESS_DENIED The application does not have the privilege to call this function.
 *
 * @par Permission:
 * Usage of this API is restricted to registered clients only.
 *
 */
mdm_result_t mdm_remove_network_configuration(const char *ssid);

mdm_result_t mdm_set_wifi_ap_setting(const char *ssid, mdm_wifi_sec_type_e securityType, const char *password);

mdm_data_t *mdm_get_wifi_ap_setting(void);

mdm_result_t mdm_allow_wifi_ap_setting_user_modification(mdm_status_t value);

mdm_status_t mdm_is_wifi_ap_setting_user_modification_allowed(void);

mdm_result_t mdm_add_wifi_ap_config(const mdm_wifi_ap_config_t *config);

mdm_result_t mdm_add_wifi_ssids_to_whitelist(GList *SSIDs);

mdm_result_t mdm_remove_wifi_ssids_from_whitelist(GList *SSIDs);

mdm_result_t mdm_clear_wifi_ssids_whitelist(void);

mdm_data_t *mdm_get_wifi_ssids_from_whitelist(void);

mdm_result_t mdm_add_wifi_ssids_to_blacklist(GList *SSIDs);

mdm_result_t mdm_remove_wifi_ssids_from_blacklist(GList *SSIDs);

mdm_result_t mdm_clear_wifi_ssids_blacklist(void);

mdm_data_t *mdm_get_wifi_ssids_from_blacklist(void);

mdm_result_t mdm_activate_wifi_ssid_restriction(mdm_status_t value);

mdm_status_t mdm_is_wifi_ssid_restriction_active(void);

mdm_result_t mdm_set_automatic_connection_to_wifi(bool enable);

mdm_status_t mdm_get_automatic_connection_to_wifi(void);

mdm_result_t mdm_set_wifi_state_change_allowed(bool allow);

mdm_status_t mdm_is_wifi_state_change_allowed(void);

mdm_result_t knox_mdm_preferred_ssid_add(const char *ssid);

mdm_result_t knox_mdm_preferred_ssid_delete(const char *ssid);

mdm_result_t knox_mdm_preferred_ssids_clear(void);

mdm_data_t *knox_mdm_preferred_ssids_get(mdm_status_t all_admins);

mdm_result_t knox_mdm_protected_ssid_add(const char *ssid);

mdm_result_t knox_mdm_protected_ssid_delete(const char *ssid);

mdm_result_t knox_mdm_protected_ssids_clear(void);

mdm_data_t *knox_mdm_protected_ssids_get(const mdm_status_t all_admins);

mdm_result_t knox_mdm_preferred_ssid_enforce(mdm_status_t status);

mdm_status_t knox_mdm_preferred_ssid_is_enforced(void);

/*
 * @brief API to check if end users have permission to change Wi-Fi configurations.
 *
 * @since_mdm 2.2.0
 *
 * @since_tizen 3.0.0.1
 *
 * @par Usage:
 * Use this API to check if end users have permission to change Wi-Fi configurations.
 *
 * @code{.c}
    mdm_status_t status = knox_mdm_get_allow_wifi_change();
    if(status == MDM_TRUE) {
        // Do something
    } else {
        // Do something
    }
 * @endcode
 *
 * @privlevel internal
 *
 * @return #mdm_status_t : Whether user can change WIFI.
 *
 * @retval #MDM_ALLOWED Allows end users to modify Wi-Fi configurations.
 * @retval #MDM_RESTRICTED Blocks end users from modifying Wi-Fi settings.
 * @retval #MDM_STATUS_ERROR Any error
 *
 * @see knox_mdm_set_allow_wifi_change
 */
mdm_status_t knox_mdm_get_allow_wifi_change(void);

/*
 * @brief API blocks end users from changing the Wi-Fi configurations.
 *
 * @since_mdm 2.2.0
 *
 * @since_tizen 3.0.0.1
 *
 * @par Usage:
 * Use this API to block end users from modifying the Wi-Fi settings. Internal usage only.
 *
 * @remark
 * WiFi state #wifi_noti_t is written to #MDM_POLICY_ON_WIFI_STATE notification file.
 * Restriction of WiFi state changing #wifi_noti_t is written to #MDM_POLICY_ON_WIFI_CHANGE notification file.
 * You can register a callbacks for both events using #mdm_register_policy_receiver.
 *
 * @code{.c}
    mdm_status_t status = knox_mdm_set_allow_wifi_change(MDM_RESTRICTED);
    if(status == MDM_TRUE) {
        // Do something
    } else {
        // Do something
    }
 * @endcode
 *
 * @param[in] status #MDM_ALLOWED — allows end users to modify Wi-Fi settings.
 *           \n #MDM_RESTRICTED — blocks end users from modifying Wi-Fi settings.
 *
 * @privlevel internal
 *
 * @return #mdm_result_t : MDM_RESULT_SUCCESS on success, an error code on error
 *
 * @retval #MDM_RESULT_SUCCESS Success
 * @retval #MDM_RESULT_FAIL General failure.
 * @retval #MDM_RESULT_SERVICE_NOT_ENABLED Service not enabled.
 * @retval #MDM_RESULT_ACCESS_DENIED Caller is not authorized to access Knox MDM client information.
 *
 * @see knox_mdm_get_allow_wifi_change
 */
mdm_result_t knox_mdm_set_allow_wifi_change(mdm_status_t status);

#ifdef __cplusplus
}
#endif

#endif // LIBMDM_MDM_WIFI_H