通过

IMbnMultiCarrier：：GetVisibleProviders 方法 (mbnapi.h)

  • 项目

重要

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

获取多运营商设备的当前区域中可见提供程序的列表，减去首选和已注册的提供程序。

语法

HRESULT GetVisibleProviders(
  [out]         ULONG     *age,
  [out, retval] SAFEARRAY **visibleProviders
);

参数

[out] age

指向自上次刷新设备的可见提供程序列表以来的时间（以秒为单位）的指针。

[out, retval] visibleProviders

指向包含接口提供程序列表的 MBN_PROVIDER2 结构的数组的指针。 如果此方法返回 除 S_OK 以外的任何值， 则 visibleProviders 为 NULL。 当 GetVisibleProviders 返回 S_OK时，调用应用程序必须通过调用 SafeArrayDestroy 释放分配的内存。

返回值

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

返回代码 说明
S_OK
 该方法已成功完成。 visibleProviders 包含有效值。 根据信息的年龄，调用应用程序可以决定向 ScanNetwork 发出新的调用
E_PENDING
 该信息不可用。 活动网络扫描正在进行中。 通过注册 IMbnMultiCarrierEvents 的 OnScanNetworkComplete 方法，调用应用程序可以在设备功能可用时收到通知
E_MBN_INVALID_CACHE
 移动宽带对可见网络列表的缓存无效。 调用应用程序应调用 ScanNetwork 来填充缓存。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
设备不支持该操作。 它可能由不支持多运营商的设备返回。

注解

此方法返回当前可见提供程序的列表。 如果其首选漫游列表中有任何网络 (PRL) 可用，CDMA 设备将仅报告其家庭提供商。

为了避免频繁的网络扫描操作，Windows 维护最近扫描操作的列表，并从缓存列表中返回提供程序列表。

完成 ScanNetwork 后，应用程序可以调用此方法来获取可见提供程序的列表。

此列表包含用户位置当前可用的所有可见网络，不包括当前注册的提供程序报告的网络和首选提供程序的列表。 此列表包含用户未订阅的网络条目。 此列表向用户提供他们可能注册的其他一组网络选项。

要求

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

另请参阅

IMbnMultiCarrier