IMbnMultiCarrier：：SetHomeProvider 方法 (mbnapi.h)

  • 项目

重要

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

汇报多运营商设备的主提供商。

语法

HRESULT SetHomeProvider(
  [in]  MBN_PROVIDER2 *homeProvider,
  [out] ULONG         *requestID
);

parameters

[in] homeProvider

包含主提供程序 的MBN_PROVIDER2 结构。

注意  

SignalStrength 和 SignalError 成员必须为 0。

 

[out] requestID

指向操作系统为此请求设置的请求 ID 的指针。 OnSetHomeProviderComplete 的异步响应将包含此相同的 requestID。

指向操作系统为此请求设置的请求 ID 的指针。 异步响应将包含此相同的 requestID。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
 该方法已成功完成。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)
移动宽带服务未在此系统上运行。
E_HANDLE
 接口无效。 移动宽带设备可能已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)
接口无效。 移动宽带设备很可能已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
设备不支持此操作。 这可能由不支持多运营商的设备返回。

注解

SetHomeProvider 方法为接口启动主提供程序的更新。 这是一个异步操作，方法调用会立即返回。 如果此方法使用 S_OK 成功返回，则 Windows 将通过调用 IMbnMultiCarrierEvents 的 OnSetHomeProviderComplete 方法，通知调用应用程序此操作的完成状态。

然后，设备将自动注册到新网络，并指示注册状态更改。 除非再次使用 SetHomeProvider 来设置新的家庭提供商，否则设备将继续在 Windows 重启后注册到此新家庭网络。

如果在此操作完成之前从系统中删除了设备，则无法保证调用应用程序会收到完成通知。

要求

   
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 mbnapi.h

另请参阅

IMbnMultiCarrier