DeviceWifiPolicyManager-Class Summary-com.huawei.android.app.admin-MDM能力

展开

Class Info
public class DeviceWifiPolicyManager WiFi管理相关类。

Class Info

public class DeviceWifiPolicyManager

WiFi管理相关类。

展开

术语解释
SSID列表：WLAN中路由器名称列表（涉及接口获取设置的企业WiFi SSID列表getWifiProfileList）
open级热点：不设置加密的热点(涉及接口WLAN禁止/允许open级热点共享策略setUnsecureSoftApDisabled)
涉及接口配置 WLAN禁止/允许用户手动添加网络策略setUserProfilesDisabled
setUserProfilesDisabled	enable	disable
Setting设置	允许用户手动添加WiFi网络策略，具体体现在WiFi列表中。	禁止时设置界面的WiFi列表中“添加其他网络”按键置灰，用户不能手动添加网络，且只允许连接配置的企业网络。

Public Method Summary

展开

Qualifier and Type	Method Name and Description
boolean	setSecurityLevel(ComponentName admin, int level) 配置WLAN允许连接的热点的最低安全级别。
int	getSecurityLevel(ComponentName admin) 获取WLAN允许连接的热点的最低安全级别。
boolean	addSsidToBlockList(ComponentName admin, ArrayList<String> ssids) 配置WLAN热点黑名单。
boolean	addSSIDToBlackList(ComponentName admin, ArrayList<String> ssids) EMUI 11.0.0该方法已废弃，请使用boolean addSsidToBlockList(ComponentName admin, ArrayList<String> ssids)。
boolean	removeSsidFromBlockList(ComponentName admin, ArrayList<String> ssids) 删除WLAN热点黑名单。
boolean	removeSSIDFromBlackList(ComponentName admin, ArrayList<String> ssids) EMUI 11.0.0该方法已废弃，请使用boolean removeSsidFromBlockList(ComponentName admin, ArrayList<String> ssids)。
ArrayList<String>	getSsidBlockList(ComponentName admin) 获取WLAN热点黑名单。
ArrayList<String>	getSSIDBlackList(ComponentName admin) EMUI 11.0.0该方法已废弃，请使用ArrayList<String> getSsidBlockList(ComponentName admin)。
boolean	isBlockListedSsid(ComponentName admin, String ssid) 判断某个WLAN热点是否在黑名单中。
boolean	isBlackListedSSID(ComponentName admin, String ssid) EMUI 11.0.0该方法已废弃，请使用boolean isBlockListedSsid(ComponentName admin, String ssid)。
boolean	setUserProfilesDisabled(ComponentName admin, boolean isDisabled) 配置 WLAN禁止/允许用户手动添加网络策略。
boolean	isUserProfilesDisabled(ComponentName admin) 查询 WLAN禁止/允许用户手动添加网络策略配置状态。
boolean	setWifiProfile(ComponentName admin, WifiConfiguration config) 配置企业WiFi。
ArrayList<String>	getWifiProfileList(ComponentName admin) 获取设置的企业WiFi SSID列表。
boolean	removeWifiProfile(ComponentName admin, WifiConfiguration config) 删除设置的企业WiFi。
boolean	isWifiProfileSet(ComponentName admin, WifiConfiguration config) 判断某个WLAN 热点是否是MDM配置的企业WiFi。
boolean	setWifiAutoConnectionDisabled(ComponentName admin, boolean isDisabled) 配置 WLAN禁止/允许自动连接WiFi热点策略。
boolean	isWifiAutoConnectionDisabled(ComponentName admin) 获取 WLAN禁止/允许自动连接WiFi热点策略配置状态。
boolean	setUnsecureSoftApDisabled(ComponentName admin, boolean isDisabled) 配置WLAN禁止/允许open级热点共享策略。
boolean	isUnsecureSoftApDisabled(ComponentName admin) 查询WLAN禁止/允许open级热点共享策略配置状态。
boolean	addSsidToTrustList(ComponentName admin, ArrayList<String> ssids) 添加WiFi热点白名单。
boolean	addSSIDToWhiteList(ComponentName admin, ArrayList<String> ssids) EMUI 11.0.0该方法已废弃，请使用boolean addSsidToTrustList(ComponentName admin, ArrayList<String> ssids)。
boolean	removeSsidFromTrustList(ComponentName admin, ArrayList<String> ssids) 删除WiFi热点白名单。
boolean	removeSSIDFromWhiteList(ComponentName admin, ArrayList<String> ssids) EMUI 11.0.0该方法已废弃，请使用boolean removeSsidFromTrustList(ComponentName admin, ArrayList<String> ssids)。
ArrayList<String>	getSsidTrustList(ComponentName admin) 查询WiFi热点白名单。
ArrayList<String>	getSSIDWhiteList(ComponentName admin) EMUI 11.0.0该方法已废弃，请使用ArrayList<String> getSsidTrustList(ComponentName admin)。
boolean	addUnavailableSsidToList(ComponentName admin, ArrayList<String> ssids) 添加不显示不可上网提示的SSID列表。
boolean	removeUnavailableSsidFromList(ComponentName admin , ArrayList<String> ssids) 移除不显示不可上网提示的SSID列表。
ArrayList<String>	getUnavailableSsidList(ComponentName admin) 查询不显示不可上网提示的SSID列表。
boolean	removeConfiguredNetworks(ComponentName admin, ArrayList<String> ssids) 删除已保存的指定WiFi热点。
boolean	setWifiProDisabled(ComponentName admin, boolean isDisabled) 禁用/启用WLAN+ 功能。
boolean	isWifiProDisabled(ComponentName admin) 获取WLAN+ 禁用状态。
boolean	turnOnWifi(ComponentName admin, boolean isOn) 开启/关闭WiFi。
boolean	turnOnWifiAp(ComponentName admin, boolean isOn) 开启/关闭WiFi热点。
boolean	setWifiApPassword(ComponentName admin,String password) 修改WiFi热点密码。
boolean	setWifiHotspot(ComponentName admin, WifiConfiguration wifiConfig) 预置WiFi热点。
boolean	setRandomMacDisabled(ComponentName admin, boolean isDisabled) 开启/关闭WiFi随机MAC。
boolean	isRandomMacDisabled(ComponentName admin) 查询WiFi随机MAC是否被禁用。
boolean	setPortalAutoConnect(ComponentName admin, boolean isAutoConnect) 禁用/启用portal热点自动连接。
boolean	isPortalAutoConnect(ComponentName admin) 获取portal热点是否自动连接状态。

Public Methods

setSecurityLevel

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 5.1及以上或HarmonyOS 2.0及以上

展开

Method
public boolean setSecurityLevel(ComponentName admin, int level) 配置WLAN允许连接的热点的最低安全级别。配置WLAN允许连接的热点安全级别之后，只有达到或高于此级别的热点可以连接，其它的热点都无法连接。安全级别根据WLAN的认证方式定义，认证方式和安全级别的映射关系如下： SECURITY_LEVEL_1 =1: OPEN SECURITY_LEVEL_2 =2: WEP SECURITY_LEVEL_3 =3: WPA SECURITY_LEVEL_4 =4: LEAP/PWD SECURITY_LEVEL_5 =5: FAST/PEAP SECURITY_LEVEL_6 =6: TLS/TTLS/SIM/AKA 注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。如果有多个应用设置了该策略，以最后一次策略设置的级别为准。

Method

public boolean setSecurityLevel(ComponentName admin, int level)

配置WLAN允许连接的热点的最低安全级别。

配置WLAN允许连接的热点安全级别之后，只有达到或高于此级别的热点可以连接，其它的热点都无法连接。安全级别根据WLAN的认证方式定义，认证方式和安全级别的映射关系如下：

SECURITY_LEVEL_1 =1: OPEN
SECURITY_LEVEL_2 =2: WEP
SECURITY_LEVEL_3 =3: WPA
SECURITY_LEVEL_4 =4: LEAP/PWD
SECURITY_LEVEL_5 =5: FAST/PEAP
SECURITY_LEVEL_6 =6: TLS/TTLS/SIM/AKA

注意：

需要申请com.huawei.permission.sec.MDM_WIFI权限。
如果有多个应用设置了该策略，以最后一次策略设置的级别为准。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
level	允许连接WLAN安全级别，取值范围在SECURITY_LEVEL_1到SECURITY_LEVEL_6之间。

Return

展开

Type	Description
boolean	true：配置成功。 false：配置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

getSecurityLevel

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 5.1及以上或HarmonyOS 2.0及以上

展开

Method
public int getSecurityLevel(ComponentName admin) 获取当前WLAN允许连接的热点的最低安全级别。配置WLAN允许连接的热点安全级别之后，只有达到或高于此级别的热点可以连接，其他的热点都无法连接。安全级别根据WLAN的认证方式定义，认证方式和安全级别的映射关系如下： SECURITY_LEVEL_1 : OPEN SECURITY_LEVEL_2 : WEP SECURITY_LEVEL_3 : WPA SECURITY_LEVEL_4 : LEAP/PWD SECURITY_LEVEL_5 : FAST/PEAP SECURITY_LEVEL_6 : TLS/TTLS/SIM/AKA

Method

public int getSecurityLevel(ComponentName admin)

获取当前WLAN允许连接的热点的最低安全级别。

配置WLAN允许连接的热点安全级别之后，只有达到或高于此级别的热点可以连接，其他的热点都无法连接。安全级别根据WLAN的认证方式定义，认证方式和安全级别的映射关系如下：

SECURITY_LEVEL_1 : OPEN
SECURITY_LEVEL_2 : WEP
SECURITY_LEVEL_3 : WPA
SECURITY_LEVEL_4 : LEAP/PWD
SECURITY_LEVEL_5 : FAST/PEAP
SECURITY_LEVEL_6 : TLS/TTLS/SIM/AKA

Parameters

展开

Name	Description
admin	调用该接口的组件名称，查询该应用配置的策略；参数为null时，获取所有应用设置的综合策略结果。

Return

展开

Type	Description
int	WLAN允许连接的热点的最低安全级别。如果未配置，则返回默认级别（SECURITY_LEVEL_1）。

addSsidToBlockList

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 11.0或HarmonyOS 2.0及以上

展开

Method
public boolean addSsidToBlockList(ComponentName admin, ArrayList<String> ssids) 配置WLAN热点黑名单，如果某个WLAN的ssid在黑名单上，则无法被连接。注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Method

public boolean addSsidToBlockList(ComponentName admin, ArrayList<String> ssids)

配置WLAN热点黑名单，如果某个WLAN的ssid在黑名单上，则无法被连接。

注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
ssids	传入的ssid不能为null，ssid列表内容不能为空，ssid列表中包含记录数量不能超过 200。经过更新的黑名单列表总长度不能超过200。单个ssid的字符串不能为null，内容不能为空，长度不能大于64。

Return

展开

Type	Description
boolean	true: 配置成功。 false：配置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

addSSIDToBlackList

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 5.1~EMUI 10.1

展开

Method
public boolean addSSIDToBlackList(ComponentName admin, ArrayList<String> ssids) EMUI 11.0.0该方法废弃，请使用addSsidToBlockList。配置WLAN热点黑名单，如果某个WLAN的ssid在黑名单上，则无法被连接。注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Method

public boolean addSSIDToBlackList(ComponentName admin, ArrayList<String> ssids)

EMUI 11.0.0该方法废弃，请使用addSsidToBlockList。

配置WLAN热点黑名单，如果某个WLAN的ssid在黑名单上，则无法被连接。

注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
ssids	传入的ssid不能为null，ssid列表内容不能为空，ssid列表中包含记录数量不能超过 200。经过更新的黑名单列表总长度不能超过200。单个ssid的字符串不能为null，内容不能为空，长度不能大于64。

Return

展开

Type	Description
boolean	true:：配置成功。 false：配置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

removeSsidFromBlockList

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 11.0或HarmonyOS 2.0及以上

展开

Method
public boolean removeSsidFromBlockList(ComponentName admin, ArrayList<String> ssids) 从WLAN允许连接热点黑名单中删除某些设备（SSID）。注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Method

public boolean removeSsidFromBlockList(ComponentName admin, ArrayList<String> ssids)

从WLAN允许连接热点黑名单中删除某些设备（SSID）。

注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

展开

Name	Description
admin	调用该接口的组件名称。
ssids	传入的ssid为null时，表示全部删除。ssids列表不能为空，ssid列表中包含记录数量不能超过200。

Return

展开

Type	Description
boolean	true：配置成功。 false：配置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

removeSSIDFromBlackList

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 5.1~EMUI 10.1

展开

Method
public boolean removeSSIDFromBlackList(ComponentName admin, ArrayList<String> ssids) EMUI 11.0.0该方法废弃，请使用removeSsidFromBlockList。从WLAN允许连接热点黑名单中删除某些设备（SSID）。注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Method

public boolean removeSSIDFromBlackList(ComponentName admin, ArrayList<String> ssids)

EMUI 11.0.0该方法废弃，请使用removeSsidFromBlockList。

从WLAN允许连接热点黑名单中删除某些设备（SSID）。

注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

展开

Name	Description
admin	调用该接口的组件名称。
ssids	传入的ssid为null时，表示全部删除。ssids列表不能为空，ssid列表中包含记录数量不能超过200。

Return

展开

Type	Description
boolean	true：配置成功。 false：配置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

getSsidBlockList

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 11.0或HarmonyOS 2.0及以上

展开

Method
public ArrayList <String> getSsidBlockList(ComponentName admin) 获取WLAN热点黑名单列表。

Method

public ArrayList <String> getSsidBlockList(ComponentName admin)

获取WLAN热点黑名单列表。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，查询该应用配置的策略；参数为null时，获取所有应用设置的综合策略结果。

Return

展开

Type	Description
ArrayList<String>	返回WLAN热点黑名单列表，不存在则返回null。

getSSIDBlackList

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 5.1~EMUI 10.1

展开

Method
public ArrayList <String> getSSIDBlackList(ComponentName admin) EMUI 11.0.0该方法废弃，请使用getSsidBlockList。获取WLAN热点黑名单列表。

Method

public ArrayList <String> getSSIDBlackList(ComponentName admin)

EMUI 11.0.0该方法废弃，请使用getSsidBlockList。

获取WLAN热点黑名单列表。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，查询该应用配置的策略；参数为null时，获取所有应用设置的综合策略结果。

Return

展开

Type	Description
ArrayList<String>	返回WLAN热点黑名单列表，不存在则返回null。

isBlockListedSsid

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 11.0或HarmonyOS 2.0及以上

展开

Method
public boolean isBlockListedSsid(ComponentName admin, String ssid) 判断某个WLAN热点是否在黑名单中。

Method

public boolean isBlockListedSsid(ComponentName admin, String ssid)

判断某个WLAN热点是否在黑名单中。

Parameters

展开

Name	Description
admin	调用该接口的组件名称。
ssid	待查询的WLAN热点的SSID。

Return

展开

Type	Description
boolean	true：该WLAN热点在黑名单中。 false：该WLAN热点不在黑名单中。

isBlackListedSSID

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 5.1~EMUI 10.1

展开

Method
public boolean isBlackListedSSID(ComponentName admin, String ssid) EMUI 11.0.0该方法废弃，请使用isBlockListedSsid。判断某个WLAN热点是否在黑名单中。

Method

public boolean isBlackListedSSID(ComponentName admin, String ssid)

EMUI 11.0.0该方法废弃，请使用isBlockListedSsid。

判断某个WLAN热点是否在黑名单中。

Parameters

展开

Name	Description
admin	调用该接口的组件名称。
ssid	待查询的WLAN热点的SSID。

Return

展开

Type	Description
boolean	true：该WLAN热点在黑名单中。 false：该WLAN热点不在黑名单中。

setUserProfilesDisabled

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 8.0及以上或HarmonyOS 2.0及以上

展开

Method
public boolean setUserProfilesDisabled(ComponentName admin, boolean isDisabled) 配置允许/禁止用户手动添加WiFi网络策略。禁止时设置界面添加修改网络按键置灰，用户不能手动添加网络，且只允许连接配置的企业网络。注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。只要有一个应用设置了禁止策略，即全局禁止手动添加WiFi网络。

Method

public boolean setUserProfilesDisabled(ComponentName admin, boolean isDisabled)

配置允许/禁止用户手动添加WiFi网络策略。禁止时设置界面添加修改网络按键置灰，用户不能手动添加网络，且只允许连接配置的企业网络。

注意：

需要申请com.huawei.permission.sec.MDM_WIFI权限。
只要有一个应用设置了禁止策略，即全局禁止手动添加WiFi网络。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
isDisabled	true：配置禁止用户手动添加WiFi网络。 false：配置允许用户手动添加WiFi网络。

Return

展开

Type	Description
boolean	true：配置成功。 false：配置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

isUserProfilesDisabled

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 8.0及以上或HarmonyOS 2.0及以上

展开

Method

public boolean isUserProfilesDisabled(ComponentName admin)

获取WLAN允许/禁止用户手动添加网络策略配置状态。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，查询该应用配置的策略；参数为null时，获取所有应用设置的综合策略结果。

Return

展开

Type	Description
boolean	true：应用禁止用户手动添加网络。 false：应用允许用户手动添加网络。

setWifiProfile

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 8.0及以上或HarmonyOS 2.0及以上

展开

Method

public boolean setWifiProfile(ComponentName admin, WifiConfiguration config)

配置MDM应用下发的企业WiFi，添加到企业WiFi SSID列表。

注意：

需要申请com.huawei.permission.sec.MDM_WIFI权限。
需要调用setUserProfilesDisabled后才能生效。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
config	要配置的企业WiFi。

Return

展开

Type	Description
boolean	true：配置成功。 false：配置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

getWifiProfileList

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 8.0及以上或HarmonyOS 2.0及以上

展开

Method

public ArrayList<String> getWifiProfileList(ComponentName admin)

获取应用设置的企业WiFi SSID列表。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，查询该应用配置的策略；参数为null时，获取所有应用设置的企业WiFi集合。

Return

展开

Type	Description
ArrayList<String>	返回应用设置的企业WiFi SSID列表，未配置则返回null。

removeWifiProfile

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 8.0及以上或HarmonyOS 2.0及以上

展开

Method

public boolean removeWifiProfile(ComponentName admin, WifiConfiguration config)

从设置的企业WiFi SSID列表中删除某个企业WiFi（SSID）。

注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

展开

Name	Description
admin	调用该接口的组件名称；参数为null时，删除所有应用设置的企业WiFi，即清空SSID列表。
config	待移除的WiFi热点（SSID）。

Return

展开

Type	Description
boolean	true：删除成功。 false：删除失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

isWifiProfileSet

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 8.0及以上或HarmonyOS 2.0及以上

展开

Method

public boolean isWifiProfileSet(ComponentName admin, WifiConfiguration config)

判断某个WLAN 热点是否是配置的企业WiFi。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，查询该应用配置的策略；参数为null时，获取所有应用设置的综合结果。
config	待查询的WLAN热点。

Return

展开

Type	Description
boolean	true：该WLAN热点在配置的企业热点列表中。 false：该WLAN热点不在配置的企业热点列表中。

setWifiAutoConnectionDisabled

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 8.0及以上或HarmonyOS 2.0及以上

展开

Method

public boolean setWifiAutoConnectionDisabled(ComponentName admin, boolean isDisabled)

配置WLAN允许/禁止自动连接WiFi热点策略。禁止时不允许WLAN发起自动连接。

注意：

需要申请com.huawei.permission.sec.MDM_WIFI权限。
只要有一个应用设置了禁止策略，即全局禁止自动连接WiFi网络。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
isDisabled	true：配置禁止自动连接WiFi网络。 false：配置允许自动连接WiFi网络。

Return

展开

Type	Description
boolean	true：配置成功。 false：配置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

isWifiAutoConnectionDisabled

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 8.0及以上或HarmonyOS 2.0及以上

展开

Method

public boolean isWifiAutoConnectionDisabled(ComponentName admin)

获取WLAN允许/禁止自动连接WiFi热点策略配置状态。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，查询该应用配置的策略；参数为null时，获取所有应用设置的综合策略结果。

Return

展开

Type	Description
boolean	true：应用禁止自动连接网络。 false：应用允许自动连接网络。

setUnsecureSoftApDisabled

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 8.0及以上或HarmonyOS 2.0及以上

展开

Method

public boolean setUnsecureSoftApDisabled(ComponentName admin, boolean isDisabled)

配置WLAN允许/禁止open级热点共享策略。禁止时不允许共享open级热点。

注意：

需要申请com.huawei.permission.sec.MDM_WIFI权限。
只要有一个MDM应用设置了禁止策略，即全局禁止共享open级热点。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
isDisabled	true：配置禁止共享open级热点。 false：配置允许共享open级热点。

Return

展开

Type	Description
boolean	true：配置成功。 false：配置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

isUnsecureSoftApDisabled

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 8.0及以上或HarmonyOS 2.0及以上

展开

Method

public boolean isUnsecureSoftApDisabled(ComponentName admin)

获取WLAN允许/禁止open级热点共享策略配置状态。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，查询该应用配置的策略；参数为null时，获取所有应用设置的综合策略结果。

Return

展开

Type	Description
boolean	true：禁止共享open级热点。 false：允许共享open级热点。

addSsidToTrustList

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 11.0或HarmonyOS 2.0及以上

展开

Method

public boolean addSsidToTrustList(ComponentName admin, ArrayList<String> ssids)

只能连接白名单内指定的热点。

注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
ssids	传入的ssid不能为null，ssid列表内容不能为空，ssid列表中包含记录数量不能超过最大限制数量200。经过更新的黑名单列表总长度不能超过最大限制数量。单个ssid的字符串不能为null，内容不能为空。

Return

展开

Type	Description
boolean	true：配置成功。 false：配置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

addSSIDToWhiteList

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 8.2~EMUI 10.1

展开

Method

public boolean addSSIDToWhiteList(ComponentName admin, ArrayList<String> ssids)

EMUI 11.0.0该方法废弃，请使用addSsidToTrustList。

只能连接白名单内指定的热点。

注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
ssids	传入的ssid不能为null，ssid列表内容不能为空，ssid列表中包含记录数量不能超过最大限制数量200。经过更新的黑名单列表总长度不能超过最大限制数量。单个ssid的字符串不能为null，内容不能为空。

Return

展开

Type	Description
boolean	true：配置成功。 false：配置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

removeSsidFromTrustList

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 11.0或HarmonyOS 2.0及以上

展开

Method

public boolean removeSsidFromTrustList(ComponentName admin, ArrayList<String> ssids)

删除WiFi热点白名单中的某些热点地址。

注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
ssids	传入的ssid不能为null，ssid列表内容不能为空，ssid列表中包含记录数量不能超过最大限制数量200。经过更新的黑名单列表总长度不能超过最大限制数量。单个 ssid 的字符串不能为null，内容不能为空。

Return

展开

Type	Description
boolean	true：删除成功。 false：删除失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

removeSSIDFromWhiteList

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 8.2~EMUI 10.1

展开

Method

public boolean removeSSIDFromWhiteList(ComponentName admin, ArrayList<String> ssids)

EMUI 11.0.0该方法废弃，请使用removeSsidFromTrustList。

删除WiFi热点白名单中的某些热点地址。

注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
ssids	传入的 ssid 不能为null，ssid列表内容不能为空，ssid列表中包含记录数量不能超过最大限制数量200。经过更新的黑名单列表总长度不能超过最大限制数量。单个ssid的字符串不能为null，内容不能为空。

Return

展开

Type	Description
boolean	true：删除成功。 false：删除失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

getSsidTrustList

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 11.0或HarmonyOS 2.0及以上

展开

Method

public ArrayList<String> getSsidTrustList(ComponentName admin)

查询WiFi热点白名单。

Parameters

展开

Name	Description
admin	调用该接口的组件名称。

Return

展开

Type	Description
ArrayList <String>	返回WLAN热点白名单列表，不存在则返回null。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。

getSSIDWhiteList

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 8.2~EMUI 10.1

展开

Method

public ArrayList<String> getSSIDWhiteList(ComponentName admin)

EMUI 11.0.0该方法废弃，请使用getSsidTrustList。

查询WiFi热点白名单。

Parameters

展开

Name	Description
admin	调用该接口的组件名称。

Return

展开

Type	Description
ArrayList <String>	返回WLAN热点白名单列表，不存在则返回null。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。

addUnavailableSsidToList

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 10.1及以上或HarmonyOS 2.0及以上

展开

Method

public boolean addUnavailableSsidToList(ComponentName admin, ArrayList<String>ssids)

添加热点名称，使得这个热点不显示不可上网的提示。

注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
ssids	需要不显示不可上网的ssid集合。

Return

展开

Type	Description
boolean	true：设置成功。 false：设置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

removeUnavailableSsidFromList

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 10.1及以上或HarmonyOS 2.0及以上

展开

Method

public boolean removeUnavailableSsidFromList(ComponentName admin, ArrayList<String> ssids)

删除不显示不可上网提示的ssid集合。

注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
ssids	需要不显示不可上网的ssid集合。

Return

展开

Type	Description
boolean	true：设置成功。 false：设置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

getUnavailableSsidList

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 10.1及以上或HarmonyOS 2.0及以上

展开

Method

public ArrayList<String> getUnavailableSsidList(ComponentName admin)

查询不显示不可上网提示的ssid集合。

Parameters

展开

Name	Description
admin	调用该接口的组件名称。

Return

展开

Type	Description
ArrayList<String>	SSID名称列表。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。

removeConfiguredNetworks

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 10.1及以上或HarmonyOS 2.0及以上

展开

Method

public boolean removeConfiguredNetworks(ComponentName admin, ArrayList<String> ssids)

根据传入的热点名称，从已保存的热点列表中删除该热点。

注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
ssids	需要从已保存热点列表中移除的ssid集合。

Return

展开

Type	Description
boolean	true：设置成功。 false：设置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

setWifiProDisabled

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 11.0或HarmonyOS 2.0及以上

展开

Method

public boolean setWifiProDisabled(ComponentName admin, boolean isDisabled)

设置WLAN+被禁用状态。

注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

展开

Name	Description
admin	调用该接口的组件名称。
isDisabled	true：禁用WLAN+功能。 false：启用WLAN+功能。

Return

展开

Type	Description
boolean	true：设置成功。 false：设置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

isWifiProDisabled

Supported Devices

展开

Device Type	OS Version
手机、平板	EMUI 11.0或HarmonyOS 2.0及以上

展开

Method

public boolean isWifiProDisabled(ComponentName admin)

获取WLAN+是否被禁用。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，参数为null时，获取所有应用设置的综合策略结果。

Return

展开

Type	Description
boolean	true：WLAN+被禁用。 false：WLAN+未被禁用。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。

turnOnWifi

Supported Devices

展开

Device Type	OS Version
手机、平板	HarmonyOS 2.1及以上

展开

Method

public boolean turnOnWifi(ComponentName admin, boolean isOn)

开启/关闭WiFi。

注意：

需要申请com.huawei.permission.sec.MDM_WIFI权限。
强制开启WiFi，或者禁用WiFi开启时，不会处理开启关闭设置。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
isOn	true：开启WiFi。 false：关闭WiFi。

Return

展开

Type	Description
boolean	true：设置成功。 false：设置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。
IllegalArgumentException	参数admin为null。

turnOnWifiAp

Supported Devices

展开

Device Type	OS Version
智慧屏	HarmonyOS 3.0及以上

展开

Method

public boolean turnOnWifiAp (ComponentName admin, boolean isOn)

开启/关闭WiFi热点。

注意：需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
isOn	true：开启WiFi热点。 false：关闭WiFi热点。

Return

展开

Type	Description
boolean	true：设置成功。 false：设置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。
IllegalArgumentException	参数admin为null。

setWifiApPassword

Supported Devices

展开

Device Type	OS Version
智慧屏	HarmonyOS 3.0及以上

展开

Method

public boolean setWifiApPassword(ComponentName admin , String password)

修改WiFi热点密码。

注意：

需要申请com.huawei.permission.sec.MDM_WIFI权限。
修改后热点会自动重启，已连接设备需要重新连接。
参数password的长度不在规定范围内时返回false。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
password	新的WiFi热点密码，长度大于7，最多63字节。

Return

展开

Type	Description
boolean	true：修改成功。 false：修改失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。
IllegalArgumentException	参数admin为null。

setWifiHotspot

Supported Devices

展开

Device Type	OS Version
手机、平板	HarmonyOS 3.1及以上

展开

Method

public boolean setWifiHotspot(ComponentName admin, WifiConfiguration wifiConfig)

预置WiFi热点。

注意：

需要申请com.huawei.permission.sec.MDM_WIFI权限。
当配置了WiFi热点白名单，且此WiFi热点不在白名单中时，无法预置。关联接口：addSsidToTrustList、removeSsidFromTrustList、getSsidTrustList。
当配置了WiFi热点黑名单，且此WiFi热点在黑名单中时，无法预置。关联接口：addSsidToBlockList、removeSsidFromBlockList、getSsidBlockList、isBlockListedSsid。
当配置了企业WiFi，且此WiFi热点不在企业WiFi列表中时，无法预置。关联接口：setWifiProfile、removeWifiProfile、getWifiProfileList、isWifiProfileSet。

Parameters

展开

Name

Description

admin

调用该接口的组件名称，不能为null。

wifiConfig

预置的WiFi热点信息，需要包含以下四个数据（详细说明见下表）：

ssid
preSharedKey
keyMgmt
hiddenSSID

展开

wifiConfig字段名称（注意大小写）	数据类型	Description
ssid	String	预置的WiFi热点的名称，不允许为null或者empty。
preSharedKey	String	预置的WiFi热点的密码，长度大于7，最多63字节。
keyMgmt	int	预置的WiFi热点的加密方式。参数取值范围： 1：wpa/wpa2 加密。 2：wpa3 加密。
isHiddenSSID	boolean	是否是隐藏热点。 true：是隐藏热点。 false：不是隐藏热点。

Return

展开

Type	Description
boolean	true：配置成功。 false：配置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。
IllegalArgumentException	参数admin为null。参数wifiConfig不符合要求。预置WiFi的ssid与WiFi热点白名单/黑名单/企业WiFi冲突。

setRandomMacDisabled

Supported Devices

展开

Device Type	OS Version
手机、平板	HarmonyOS 3.1及以上

展开

Method

public boolean setRandomMacDisabled(ComponentName admin, boolean isDisabled)

禁用/启用WiFi随机MAC。

注意：

需要申请com.huawei.permission.sec.MDM_WIFI权限。
禁用后用户仍然可以在“设置-WLAN-（点击某个热点）-隐私”处选择“使用随机MAC”，但是不会生效，实际使用的是本机MAC。
对于在调用接口之前已连接以及已保存的WiFi，必须先清除WiFi信息并重新连接，此接口才会生效。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
isDisabled	true：禁用WiFi随机MAC。 false：启用WiFi随机MAC。

Return

展开

Type	Description
boolean	true：设置成功。 false：设置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。
IllegalArgumentException	参数admin为null。

isRandomMacDisabled

Supported Devices

展开

Device Type	OS Version
手机、平板	HarmonyOS 3.1及以上

展开

Method

public boolean isRandomMacDisabled(ComponentName admin)

查询WiFi随机MAC是否被禁用。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，参数为null时，获取所有应用设置的综合策略结果。

Return

展开

Type	Description
boolean	true：WiFi随机MAC被禁用。 false：WiFi随机MAC未被禁用。

Throws

展开

Name	Description
SecurityException	指定的admin未激活。参数admin非法。

setPortalAutoConnect

Supported Devices

展开

Device Type	OS Version
手机、平板	HarmonyOS 4.0及以上

展开

Method

public boolean setPortalAutoConnect(ComponentName admin, boolean isAutoConnect)

禁用/启用portal热点自动连接。

注意：

需要申请com.huawei.permission.sec.MDM_WIFI权限。
需要设置WLAN+默认关闭。
MAC上报真实地址进行认证。
设置成功后需要重启WiFi，防止该热点被加入黑名单导致不能连接。
主要是支持已保存但未通过鉴权的Portal热点的自动连接。

Parameters

展开

Name	Description
admin	调用该接口的组件名称，不能为null。
isAutoConnect	true：自动连接Portal热点。 false：不自动连接Portal热点。

Return

展开

Type	Description
boolean	true：配置成功。 false：配置失败。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。无com.huawei.permission.sec.MDM_WIFI权限。

isPortalAutoConnect

Supported Devices

展开

Device Type	OS Version
手机、平板	HarmonyOS 4.0及以上

展开

Method

public boolean isPortalAutoConnect(ComponentName admin)

获取Portal热点是否自动连接状态。

Parameters

展开

Name	Description
admin	调用该接口的组件名称。

Return

展开

Type	Description
boolean	true：自动连接Portal热点。 false：不自动连接Portal热点。

Throws

展开

Name	Description
SecurityException	此APK未经设备管理激活。