IMbnMultiCarrierEvents：：OnScanNetworkComplete 方法 (mbnapi.h)

重要

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

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

语法

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

[in] mbnInterface

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

[in] requestID

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

[in] status

指示 ScanNetwork 结果的状态代码。

值	含义
S_OK	操作成功。
E_MBN_RADIO_POWER_OFF	无法获取可见的网络列表，因为设备无线电已关闭。应用程序可以在收到无线电打开通知时发出网络扫描请求。
E_MBN_DEVICE_BUSY	设备正忙，当前无法执行网络扫描操作。这由不支持网络扫描操作的设备在建立数据连接时返回。
E_MBN_ALREADY_ACTIVE	网络扫描操作已在进行中。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)	设备不支持此操作。这可能由不支持多运营商的设备返回。

此方法必须返回 S_OK。

如果状态为S_OK，则移动宽带服务已成功更新可见提供程序的缓存列表。然后，应用程序可以调用传递的 IMbnMultiCarrier 的 GetVisibleProviders 方法以获取可见提供程序的列表。

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