IMbnInterface：：GetVisibleProviders 方法 (mbnapi.h)

重要

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

获取可见提供程序的列表。

语法

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

[out, retval] age

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

[out, retval] visibleProviders

指向包含接口提供程序列表的MBN_PROVIDER 结构的数组的指针。如果此方法返回 除 S_OK 以外的任何值，则此参数为 NULL。否则，在完成后，调用程序必须通过调用 SafeArrayDestroy 释放分配的内存。

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

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

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

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

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