@ohos.enterprise.wifiManager（WiFi管理）

本模块提供企业设备WiFi管理能力，包括查询WiFi开启状态等。仅企业设备管理员应用才能调用。

说明：

本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 本模块接口需激活为设备管理员应用后才能调用，实现相应功能。

导入模块

import wifiManager from '@ohos.enterprise.wifiManager';

wifiManager.isWifiActive

isWifiActive(admin: Want, callback: AsyncCallback<boolean>): void

指定设备管理员应用查询wifi开启状态，使用callback形式返回wifi开启状态。

需要权限： ohos.permission.ENTERPRISE_SET_WIFI

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

系统API: 此接口为系统接口。

参数：

错误码：

以下的错误码的详细介绍请参见企业设备管理错误码

示例：

let wantTemp = {
    bundleName: "com.example.myapplication",
    abilityName: "EntryAbility",
};
wifiManager.isWifiActive(wantTemp, (error, result) => {
    if (error != null) {
        console.log("error code:" + error.code + " error message:" + error.message);
        return;
    }
    console.log("result:" + result);
});

wifiManager.isWifiActive

isWifiActive(admin: Want): Promise<boolean>

获取wifi开启状态，使用Promise形式返回wifi开启状态。

需要权限： ohos.permission.ENTERPRISE_SET_WIFI

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

系统API: 此接口为系统接口。

参数：

返回值：

错误码：

以下的错误码的详细介绍请参见企业设备管理错误码

示例：

let wantTemp = {
    bundleName: "com.example.myapplication",
    abilityName: "EntryAbility",
};
wifiManager.isWifiActive(wantTemp).then((result) => {
    console.log("result:" + result);
}).catch(error => {
    console.log("error code:" + error.code + " error message:" + error.message);
});

wifiManager.setWifiProfile

setWifiProfile(admin: Want, profile: WifiProfile, callback: AsyncCallback<void>): void

配置wifi，使连接到指定网络，使用callback返回配置结果。

需要权限： ohos.permission.ENTERPRISE_SET_WIFI

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

系统API: 此接口为系统接口。

参数：

错误码：

以下的错误码的详细介绍请参见企业设备管理错误码

示例：

let wantTemp = {
    bundleName: "com.example.myapplication",
    abilityName: "EntryAbility",
};
let profile : wifiManager.WifiProfile = {
    "ssid": "name",
    "preSharedKey": "passwd",
    "securityType": wifiManager.WifiSecurityType.WIFI_SEC_TYPE_PSK
};
wifiManager.setWifiProfile(wantTemp, profile, (error) => {
    if (error != null) {
        console.log("error code:" + error.code + " error message:" + error.message);
        return;
    }
    console.log("set wifi success");
});

wifiManager.setWifiProfile

setWifiProfile(admin: Want, profile: WifiProfile): Promise<void>

配置wifi，使连接到指定网络，使用Promise返回配置结果。

需要权限： ohos.permission.ENTERPRISE_SET_WIFI

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

系统API: 此接口为系统接口。

参数：

返回值：

错误码：

以下的错误码的详细介绍请参见企业设备管理错误码

示例：

let wantTemp = {
    bundleName: "com.example.myapplication",
    abilityName: "EntryAbility",
};
let profile : wifiManager.WifiProfile = {
    "ssid": "name",
    "preSharedKey": "passwd",
    "securityType": wifiManager.WifiSecurityType.WIFI_SEC_TYPE_PSK
};
wifiManager.setWifiProfile(wantTemp, profile).then(() => {
    console.log("set wifi success");
}).catch(error => {
    console.log("error code:" + error.code + " error message:" + error.message);
});

WifiProfile

WLAN配置信息

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

系统API: 此接口为系统接口。

WifiSecurityType

表示加密类型的枚举。

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

系统API: 此接口为系统接口。

IpType

表示IP类型的枚举。

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

系统API: 此接口为系统接口。

IpProfile

IP配置信息。

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

系统API: 此接口为系统接口。

WifiEapProfile

可扩展身份验证协议配置信息。

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

系统API: 此接口为系统接口。

EapMethod

表示EAP认证方式的枚举。

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

系统API: 此接口为系统接口。

Phase2Method

表示第二阶段认证方式的枚举。

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

系统API: 此接口为系统接口。