# @ohos.enterprise.networkManager(网络管理) 本模块提供设备网络管理能力,包括查询设备IP地址、MAC地址信息等。仅企业设备管理员应用才能调用。 > **说明:** > > 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块接口需激活为[设备管理员应用](js-apis-enterprise-adminManager.md#adminmanagerenableadmin)后才能调用,实现相应功能。 ## 导入模块 ```js import networkManager from '@ohos.enterprise.networkManager'; ``` ## networkManager.getAllNetworkInterfaces getAllNetworkInterfaces(admin: Want, callback: AsyncCallback<Array<string>>): void 指定设备管理员应用获取所有活动的网络接口,使用callback形式返回网络接口名称数组。 **需要权限:** ohos.permission.ENTERPRISE_GET_NETWORK_INFO **系统能力:** SystemCapability.Customization.EnterpriseDeviceManager **系统API**: 此接口为系统接口。 **参数:** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | ------------------------------- | | admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | | callback | AsyncCallback<Array<string>> | 是 | 回调函数。当接口调用成功,err为null,data为网络接口名称数组,否则err为错误对象。 | **错误码**: 以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) | 错误码ID | 错误信息 | | ------- | ---------------------------------------------------------------------------- | | 9200001 | the application is not an administrator of the device. | | 9200002 | the administrator application does not have permission to manage the device. | **示例:** ```js let wantTemp = { bundleName: "com.example.myapplication", abilityName: "EntryAbility", }; networkManager.getAllNetworkInterfaces(wantTemp, (error, result) => { if (error != null) { console.log("error code:" + error.code + " error message:" + error.message); return; } console.log(JSON.stringify(result)); }); ``` ## networkManager.getAllNetworkInterfaces getAllNetworkInterfaces(admin: Want): Promise<Array<string>> 指定设备管理员应用获取所有活动的网络接口,使用Promise形式返回网络接口名称数组。 **需要权限:** ohos.permission.ENTERPRISE_GET_NETWORK_INFO **系统能力:** SystemCapability.Customization.EnterpriseDeviceManager **系统API**: 此接口为系统接口。 **参数:** | 参数名 | 类型 | 必填 | 说明 | | ----- | ----------------------------------- | ---- | ------- | | admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | **返回值:** | 类型 | 说明 | | --------------------- | ------------------------- | | Promise<Array<string>> | Promise结果,返回网络接口名称数组。 | **错误码**: 以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) | 错误码ID | 错误信息 | | ------- | ---------------------------------------------------------------------------- | | 9200001 | the application is not an administrator of the device. | | 9200002 | the administrator application does not have permission to manage the device. | **示例:** ```js let wantTemp = { bundleName: "com.example.myapplication", abilityName: "EntryAbility", }; networkManager.getAllNetworkInterfaces(wantTemp).then((result) => { console.log(JSON.stringify(result)); }).catch(error => { console.log("error code:" + error.code + " error message:" + error.message); }); ``` ## networkManager.getIpAddress getIpAddress(admin: Want, networkInterface: string, callback: AsyncCallback<string>): void 指定设备管理员应用根据networkInterface获取设备IP地址,使用callback形式返回设备IP地址。 **需要权限:** ohos.permission.ENTERPRISE_GET_NETWORK_INFO **系统能力:** SystemCapability.Customization.EnterpriseDeviceManager **系统API**: 此接口为系统接口。 **参数:** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | ------------------------------- | | admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | | networkInterface | string | 是 | 指定网络接口。 | | callback | AsyncCallback<string> | 是 | 回调函数。当接口调用成功,err为null,data为IP地址,否则err为错误对象。 | **错误码**: 以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) | 错误码ID | 错误信息 | | ------- | ---------------------------------------------------------------------------- | | 9200001 | the application is not an administrator of the device. | | 9200002 | the administrator application does not have permission to manage the device. | **示例:** ```js let wantTemp = { bundleName: "com.example.myapplication", abilityName: "EntryAbility", }; networkManager.getIpAddress(wantTemp, "eth0", (error, result) => { if (error != null) { console.log("error code:" + error.code + " error message:" + error.message); return; } console.log(result); }); ``` ## networkManager.getIpAddress getIpAddress(admin: Want, networkInterface: string): Promise<string> 指定设备管理员应用根据networkInterface获取设备IP地址,使用Promise形式返回设备IP地址。 **需要权限:** ohos.permission.ENTERPRISE_GET_NETWORK_INFO **系统能力:** SystemCapability.Customization.EnterpriseDeviceManager **系统API**: 此接口为系统接口。 **参数:** | 参数名 | 类型 | 必填 | 说明 | | ----- | ----------------------------------- | ---- | ------- | | admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | | networkInterface | string | 是 | 指定网络接口。 | **返回值:** | 类型 | 说明 | | --------------------- | ------------------------- | | Promise<string> | Promise结果,返回设备IP地址。 | **错误码**: 以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) | 错误码ID | 错误信息 | | ------- | ---------------------------------------------------------------------------- | | 9200001 | the application is not an administrator of the device. | | 9200002 | the administrator application does not have permission to manage the device. | **示例:** ```js let wantTemp = { bundleName: "com.example.myapplication", abilityName: "EntryAbility", }; networkManager.getIpAddress(wantTemp, "eth0").then((result) => { console.log(result); }).catch(error => { console.log("error code:" + error.code + " error message:" + error.message); }); ``` ## networkManager.getMac getMac(admin: Want, networkInterface: string, callback: AsyncCallback<string>): void 指定设备管理员应用根据networkInterface获取设备MAC地址,使用callback形式返回设备MAC地址。 **需要权限:** ohos.permission.ENTERPRISE_GET_NETWORK_INFO **系统能力:** SystemCapability.Customization.EnterpriseDeviceManager **系统API**: 此接口为系统接口。 **参数:** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | ------------------------------- | | admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | | networkInterface | string | 是 | 指定网络接口。 | | callback | AsyncCallback<string> | 是 | 回调函数。当接口调用成功,err为null,data为设备MAC地址,否则err为错误对象。 | **错误码**: 以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) | 错误码ID | 错误信息 | | ------- | ---------------------------------------------------------------------------- | | 9200001 | the application is not an administrator of the device. | | 9200002 | the administrator application does not have permission to manage the device. | **示例:** ```js let wantTemp = { bundleName: "com.example.myapplication", abilityName: "EntryAbility", }; networkManager.getMac(wantTemp, "eth0", (error, result) => { if (error != null) { console.log("error code:" + error.code + " error message:" + error.message); return; } console.log(result); }); ``` ## networkManager.getMac getIpAddress(admin: Want, networkInterface: string): Promise<string> 指定设备管理员应用根据networkInterface获取设备MAC地址,使用Promise形式返回设备IP地址。 **需要权限:** ohos.permission.ENTERPRISE_GET_NETWORK_INFO **系统能力:** SystemCapability.Customization.EnterpriseDeviceManager **系统API**: 此接口为系统接口。 **参数:** | 参数名 | 类型 | 必填 | 说明 | | ----- | ----------------------------------- | ---- | ------- | | admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | | networkInterface | string | 是 | 指定网络接口。 | **返回值:** | 类型 | 说明 | | --------------------- | ------------------------- | | Promise<string> | Promise结果,返回设备MAC地址。 | **错误码**: 以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) | 错误码ID | 错误信息 | | ------- | ---------------------------------------------------------------------------- | | 9200001 | the application is not an administrator of the device. | | 9200002 | the administrator application does not have permission to manage the device. | **示例:** ```js let wantTemp = { bundleName: "com.example.myapplication", abilityName: "EntryAbility", }; networkManager.getMac(wantTemp, "eth0").then((result) => { console.log(result); }).catch(error => { console.log("error code:" + error.code + " error message:" + error.message); }); ``` ## networkManager.isNetworkInterfaceDisabled isNetworkInterfaceDisabled(admin: Want, networkInterface: string, callback: AsyncCallback<boolean>): void 指定设备管理员应用查询指定网络接口是否被禁用,使用callback形式返回网络接口是否被禁用。 **需要权限:** ohos.permission.ENTERPRISE_GET_NETWORK_INFO **系统能力:** SystemCapability.Customization.EnterpriseDeviceManager **系统API**: 此接口为系统接口。 **参数:** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | ------------------------------- | | admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | | networkInterface | string | 是 | 指定网络接口。 | | callback | AsyncCallback<boolean> | 是 | 回调函数。当接口调用成功,err为null,data为指定网络接口是否被禁用,true表示该网络接口被禁用,false表示该网络接口未被禁用,否则err为错误对象。 | **错误码**: 以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) | 错误码ID | 错误信息 | | ------- | ---------------------------------------------------------------------------- | | 9200001 | the application is not an administrator of the device. | | 9200002 | the administrator application does not have permission to manage the device. | **示例:** ```js let wantTemp = { bundleName: "com.example.myapplication", abilityName: "EntryAbility", }; networkManager.isNetworkInterfaceDisabled(wantTemp, "eth0", (error, result) => { if (error != null) { console.log("error code:" + error.code + " error message:" + error.message); return; } console.log("result:" + result); }); ``` ## networkManager.isNetworkInterfaceDisabled isNetworkInterfaceDisabled(admin: Want, networkInterface: string): Promise<boolean> 指定设备管理员应用查询指定网络接口是否被禁用,使用Promise形式返回指定网络接口是否被禁用。 **需要权限:** ohos.permission.ENTERPRISE_GET_NETWORK_INFO **系统能力:** SystemCapability.Customization.EnterpriseDeviceManager **系统API**: 此接口为系统接口。 **参数:** | 参数名 | 类型 | 必填 | 说明 | | ----- | ----------------------------------- | ---- | ------- | | admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | | networkInterface | string | 是 | 指定网络接口。 | **返回值:** | 类型 | 说明 | | --------------------- | ------------------------- | | Promise<boolean> | Promise结果,返回指定网络接口是否被禁用,true表示该网络接口被禁用,false表示该网络接口未被禁用。 | **错误码**: 以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) | 错误码ID | 错误信息 | | ------- | ---------------------------------------------------------------------------- | | 9200001 | the application is not an administrator of the device. | | 9200002 | the administrator application does not have permission to manage the device. | **示例:** ```js let wantTemp = { bundleName: "com.example.myapplication", abilityName: "EntryAbility", }; networkManager.isNetworkInterfaceDisabled(wantTemp, "eth0").then((result) => { console.log("result:" + result); }).catch(error => { console.log("error code:" + error.code + " error message:" + error.message); }); ``` ## networkManager.setNetworkInterfaceDisabled setNetworkInterfaceDisabled(admin: Want, networkInterface: string, isDisabled: boolean, callback: AsyncCallback<void>): void 指定设备管理员应用禁用指定网络接口,使用callback形式返回。 **需要权限:** ohos.permission.ENTERPRISE_SET_NETWORK **系统能力:** SystemCapability.Customization.EnterpriseDeviceManager **系统API**: 此接口为系统接口。 **参数:** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | ------------------------------- | | admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | | networkInterface | string | 是 | 指定网络接口。 | | isDisabled | boolean | 是 | true表示禁用该网络接口,false表示开启该网络接口。 | | callback | AsyncCallback<void> | 是 | 回调函数。当接口调用成功,err为null,否则err为错误对象。 | **错误码**: 以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) | 错误码ID | 错误信息 | | ------- | ---------------------------------------------------------------------------- | | 9200001 | the application is not an administrator of the device. | | 9200002 | the administrator application does not have permission to manage the device. | **示例:** ```js let wantTemp = { bundleName: "com.example.myapplication", abilityName: "EntryAbility", }; networkManager.setNetworkInterfaceDisabled(wantTemp, "eth0", true, (error) => { if (error != null) { console.log("error code:" + error.code + " error message:" + error.message); return; } console.log("setNetworkInterfaceDisabled success!"); }); ``` ## networkManager.setNetworkInterfaceDisabled setNetworkInterfaceDisabled(admin: Want, networkInterface: string, isDisabled: boolean): Promise<void> 指定设备管理员应用禁用指定网络接口,使用Promise形式返回。 **需要权限:** ohos.permission.ENTERPRISE_SET_NETWORK **系统能力:** SystemCapability.Customization.EnterpriseDeviceManager **系统API**: 此接口为系统接口。 **参数:** | 参数名 | 类型 | 必填 | 说明 | | ----- | ----------------------------------- | ---- | ------- | | admin | [Want](js-apis-app-ability-want.md) | 是 | 设备管理员应用。 | | networkInterface | string | 是 | 指定网络接口。 | | isDisabled | boolean | 是 | true表示禁用该网络接口,false表示开启该网络接口。 | **返回值:** | 类型 | 说明 | | --------------------- | ------------------------- | | Promise<void> | 无返回结果的Promise对象。当禁用网络接口失败时抛出错误对象 | **错误码**: 以下的错误码的详细介绍请参见[企业设备管理错误码](../errorcodes/errorcode-enterpriseDeviceManager.md) | 错误码ID | 错误信息 | | ------- | ---------------------------------------------------------------------------- | | 9200001 | the application is not an administrator of the device. | | 9200002 | the administrator application does not have permission to manage the device. | **示例:** ```js let wantTemp = { bundleName: "com.example.myapplication", abilityName: "EntryAbility", }; networkManager.setNetworkInterfaceDisabled(wantTemp, "eth0", true).then(() => { console.log("setNetworkInterfaceDisabled success!"); }).catch(error => { console.log("error code:" + error.code + " error message:" + error.message); }); ```