IMbnInterface::GetVisibleProviders 方法 (mbnapi.h)

重要

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

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

语法

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

parameters

[out, retval] age

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

[out, retval] visibleProviders

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

返回值

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

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

注解

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

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

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

要求

   
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 mbnapi.h

另请参阅

IMbnInterface