Network Mode Configuration

SetNetworkMode

API Description

This API is used to set the network mode to enterprise intranet access if the media nodes of Huawei Cloud Meeting are deployed in an enterprise and management nodes are accessed through the proxy of the enterprise.

This API needs to be called only when the app cannot directly access the public network (that is, when the media nodes and management nodes are deployed in the enterprise).

Precautions

This API is optional. If it is not called, the default mode is used.
This API is an asynchronous API. The return value only indicates whether the API is successfully called. The actual service processing result is returned in the corresponding callback function.

Method Definition

    
         HWM_SDK_AGENT_API hwmsdk::HwmErrCode SetNetworkMode(const HwmNetWorkModeInfo* networkInfo);

Callback Function

    
         virtual void OnSetNetworkModeResult(hwmsdk::HwmErrCode ret, const char* reason) {};

Parameter Description

**Table 1** Parameter description
Parameter	Mandatory	Type	Description
networkInfo	Yes	HwmNetWorkModeInfo	Network mode information.

**Table 2** HwmNetWorkModeInfo parameters
Parameter	Mandatory	Type	Description
accessType	Yes	HwmNetworkAccessType	Network access type.
isForcedVpn	Yes	bool	Whether to forcibly use a VPN. The default value is false.

**Table 3** HwmNetworkAccessType parameters
Enumerated Value	Description
ACCESS_TYPE_AUTO	Default value. Currently, the value is the same as the extranet access mode.
ACCESS_TYPE_INNER	Intranet access, which is used when the media and signaling nodes are deployed in the enterprise. The app uses the intranet for access. Signaling and media messages access the Huawei Cloud Meeting server through the proxy server.
ACCESS_TYPE_OUTER	External network access, which is used when the media and signaling nodes are not deployed in the enterprise. The app uses the Internet for access. Signaling and media messages access the Huawei Cloud Meeting server through the proxy server.

Return Values

**Table 4** Return values
Type	Description
HwmErrCode	If 0 is returned, the operation is successful. If other values are returned, the operation fails. For details about values returned upon failures, see Common Error Codes.

Sample Code

    
         /**
* Set the network mode.
*/
void demoSetNetworkModeDlg::SetNetworkMode()
{
    hwmsdkagent::HwmNetWorkModeInfo networkMode{};
    networkMode.accessType = hwmsdkagent::HwmNetworkAccessType::ACCESS_TYPE_AUTO;
    int ret = hwmsdkagent::SetNetworkMode(&networkMode);
    if (hwmsdk::HWM_COMMON_SUCCESS != ret)
    {
        AfxMessageBox(_T("Set network mode failed"));
    }
}