@ohos.enterprise.wifiManager（WiFi管理）(系统接口)

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

说明：

本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

本模块接口仅可在Stage模型下使用。

本模块接口仅对设备管理应用开放，需将设备管理应用激活后调用。

当前页面仅包含本模块的系统接口，其他公开接口参见。其他公开接口参见@ohos.enterprise.wifiManager。

导入模块

import { wifiManager } from '@kit.MDMKit';

wifiManager.isWifiActive

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

查询当前设备的Wi-Fi开启状态。使用callback异步回调。

需要权限： ohos.permission.ENTERPRISE_SET_WIFI

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

参数：

错误码：

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

示例：

import { Want } from '@kit.AbilityKit';

let wantTemp: Want = {
  bundleName: 'com.example.myapplication',
  abilityName: 'EntryAbility',
};

wifiManager.isWifiActive(wantTemp, (err, result) => {
  if (err) {
    console.error(`Failed to query is wifi active or not. Code: ${err.code}, message: ${err.message}`);
    return;
  }
  console.info(`Succeeded in query is wifi active or not, result : ${result}`);
});

wifiManager.isWifiActive

isWifiActive(admin: Want): Promise<boolean>

查询当前设备的Wi-Fi开启状态。使用Promise异步回调。

需要权限： ohos.permission.ENTERPRISE_SET_WIFI

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

参数：

返回值：

错误码：

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

示例：

import { Want } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let wantTemp: Want = {
  bundleName: 'com.example.myapplication',
  abilityName: 'EntryAbility',
};

wifiManager.isWifiActive(wantTemp).then((result) => {
  console.info(`Succeeded in query is wifi active or not, result : ${result}`);
}).catch((err: BusinessError) => {
  console.error(`Failed to query is wifi active or not. Code: ${err.code}, message: ${err.message}`);
});

wifiManager.setWifiProfile

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

为当前设备配置Wi-Fi，使连接到指定网络。使用callback异步回调。

需要权限： ohos.permission.ENTERPRISE_SET_WIFI

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

参数：

错误码：

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

示例：

import { Want } from '@kit.AbilityKit';

let wantTemp: Want = {
  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, (err) => {
  if (err) {
    console.error(`Failed to set wifi profile. Code: ${err.code}, message: ${err.message}`);
    return;
  }
  console.info('Succeeded in setting wifi profile');
});

wifiManager.setWifiProfile

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

为当前设备配置Wi-Fi，使连接到指定网络。使用Promise异步回调。

需要权限： ohos.permission.ENTERPRISE_SET_WIFI

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

参数：

返回值：

错误码：

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

示例：

import { Want } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let wantTemp: Want = {
  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.info('Succeeded in setting wifi profile');
}).catch((err: BusinessError) => {
  console.error(`Failed to set wifi profile. Code: ${err.code}, message: ${err.message}`);
});

wifiManager.isWifiDisabled¹¹⁺

isWifiDisabled(admin: Want): boolean

查询当前设备Wi-Fi是否被禁用。

需要权限： ohos.permission.ENTERPRISE_MANAGE_WIFI

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

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

参数：

返回值：

错误码：

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

示例：

import { Want } from '@kit.AbilityKit';

let wantTemp: Want = {
  bundleName: 'com.example.myapplication',
  abilityName: 'EntryAbility',
};
try {
  let result: boolean = wifiManager.isWifiDisabled(wantTemp);
  console.info(`Succeeded in query the wifi is disabled or not, result : ${result}`);
} catch (err) {
  console.error(`Failed to query the wifi is disabled or not. Code: ${err.code}, message: ${err.message}`);
};

wifiManager.setWifiDisabled¹¹⁺

setWifiDisabled(admin: Want, disabled: boolean): void

设置禁用Wi-Fi策略。

需要权限： ohos.permission.ENTERPRISE_MANAGE_WIFI

系统能力： SystemCapability.Customization.EnterpriseDeviceManager

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

参数：

错误码：

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

示例：

import { Want } from '@kit.AbilityKit';

let wantTemp: Want = {
  bundleName: 'com.example.myapplication',
  abilityName: 'EntryAbility',
};

try {
  wifiManager.setWifiDisabled(wantTemp, true);
  console.info('Succeeded in set the wifi disabled');
} catch (err) {
  console.error(`Failed to set the wifi disabled. Code: ${err.code}, message: ${err.message}`);
};

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Mdm Kit（企业设备管理服务）

harmony 鸿蒙企业设备管理错误码

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility（企业设备管理扩展能力）

harmony 鸿蒙@ohos.enterprise.accountManager（账户管理）(系统接口)

harmony 鸿蒙@ohos.enterprise.accountManager（账户管理）

harmony 鸿蒙@ohos.enterprise.adminManager（企业设备管理）(系统接口)

harmony 鸿蒙@ohos.enterprise.adminManager (admin权限管理)

harmony 鸿蒙@ohos.enterprise.applicationManager（应用管理）(系统接口)

harmony 鸿蒙@ohos.enterprise.applicationManager（应用管理）

harmony 鸿蒙@ohos.enterprise.bluetoothManager（蓝牙管理）(系统接口)