IMbnInterfaceEvents：：OnScanNetworkComplete 方法 (mbnapi.h)

重要

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

移动宽带服务调用此通知方法以指示网络扫描完成。

语法

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

[in] newInterface

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

[in] requestID

移动宽带服务为此通知分配的请求 ID。

[in] status

操作完成状态

调用应用程序可能需要以下值之一。

S_OK

操作成功。

E_MBN_RADIO_POWER_OFF

无法获取可见的网络列表，因为设备无线电已关闭。应用程序可以在收到无线电打开通知时发出网络扫描请求。

E_MBN_DEVICE_BUSY

设备正忙，当前无法执行网络扫描操作。这由不支持网络扫描操作的设备在建立数据连接时返回。

E_MBN_ALREADY_ACTIVE

网络扫描操作已在进行中。

此方法必须返回 S_OK。

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

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