IMbnInterfaceEvents：：OnSetPreferredProvidersComplete 方法 (mbnapi.h)

重要

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

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

语法

HRESULT OnSetPreferredProvidersComplete(
  [in] IMbnInterface *newInterface,
  [in] ULONG         requestID,
  [in] HRESULT       status
);

[in] newInterface

一个 IMbnInterface，表示执行此操作的设备。

[in] requestID

移动宽带服务为此异步操作分配的请求 ID。

[in] status

操作完成状态。

下表列出了此状态的有效值。

值	含义
S_OK	操作成功。
E_MBN_PIN_REQUIRED	设备需要输入 PIN 才能完成此操作。
E_MBN_SIM_NOT_INSERTED	未插入 SIM 卡。
E_MBN_BAD_SIM	设备中插入了错误的 SIM 卡。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)	设备不支持此操作。

此方法必须返回 S_OK。

如果操作成功完成，即当状态为S_OK时，应用程序可以调用传递的 IMbnInterface 的 GetPreferredProviders 方法以获取首选提供程序的更新列表。

如果多个应用程序注册了通知，则将在所有已注册的应用程序上调用此方法。这意味着未启动更新操作的应用程序也会收到通知。

如果对 IMbnInterface 的 SetPreferredProviders 方法的调用导致首选提供程序列表中的更改，则不会调用 IMbnInterfaceEvents 的 OnPreferredProvidersChange 方法。