IMbnMultiCarrierEvents：：OnSetHomeProviderComplete 方法 (mbnapi.h)

重要

从 Windows 10 版本 1803 开始，本部分所述的 Win32 API 将替换为 Windows.Networking.Connectivity 命名空间中的Windows 运行时 API。

移动宽带服务调用此通知方法以指示 SetHomeProvider 操作已完成。

语法

HRESULT OnSetHomeProviderComplete(
  [in] IMbnMultiCarrier *mbnInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

[in] mbnInterface

表示移动宽带设备 SetHomeProvider 操作的 IMbnMultiCarrier 对象。

[in] requestID

移动宽带服务分配给 SetHomeProvider 操作的请求 ID。

[in] status

指示 SetHomeProvider 结果的状态代码。

值	含义
S_OK	操作成功。
E_MBN_PROVIDER_NOT_VISIBLE	请求的提供程序不可见。
E_INVALIDARG	注册模式输入无效，作为输入提供的提供程序 ID 长于最大长度 7 个字符，或者提供的数据类无效。在输入中提供无效参数时，移动宽带服务不会将请求发送到设备。在手动注册模式下，这表示请求的提供程序被禁止。
E_FAIL	操作无法完成。有关详细信息，请参阅网络错误代码。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)	设备不支持此操作。这可能由不支持多运营商的设备返回。

此方法必须返回 S_OK。

如果状态为S_OK，则 SetHomeProvider 已成功将接口的主提供程序设置为新提供程序。否则，原始主提供程序不会更改，并且接口的先前状态（如连接、数据包服务等）保持不变。