IMbnMultiCarrier：：ScanNetwork 方法 (mbnapi.h)

重要

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

扫描网络以获取多运营商设备的可见提供程序列表。

语法

HRESULT ScanNetwork(
  [out] ULONG *requestID
);

[out] requestID

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

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

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

此方法启动网络扫描操作。成功完成后，它将填充操作系统的可见提供程序缓存，应用程序可以调用 IMbnMultiCarrier 的 GetVisibleProviders 方法来获取可见网络的列表。

这是一个耗时的操作。因此，应用程序应首先调用 GetVisibleProviders，并且仅当缓存的信息已过时时才调用 ScanNetwork 。

这是一个异步操作， ScanNetwork 将立即返回。如果此方法使用 S_OK) 成功返回 (，则在扫描操作完成后，操作系统将调用 IMbnMultiCarrierEvents 的 OnScanNetworkComplete 方法，以通知应用程序操作完成。

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