IMbnConnectionContext：：GetProvisionedContexts 方法 (mbnapi.h)
重要
从 Windows 10 版本 1803 开始，本部分所述的 Win32 API 将替换为 Windows.Networking.Connectivity 命名空间中的Windows 运行时 API。
获取连接上下文的列表。
语法
HRESULT GetProvisionedContexts(
[out, retval] SAFEARRAY **provisionedContexts
);
parameters
[out, retval] provisionedContexts
表示设备中存储的连接上下文 的MBN_CONTEXT 值列表。 出现错误时，此数组为 NULL。 成功后，调用应用程序必须通过调用 SafeArrayDestroy 释放分配的内存。
返回值
此方法可以返回其中一个值。
| 返回代码 | 说明 |
|---|---|
|
该方法已成功完成。 |
|
连接上下文不可用。 移动宽带服务正在探测设备以获取信息。 通过注册 IMbnConnectionContextEvents 的 OnProvisionedContextListChange 方法，当连接上下文可用时，调用应用程序可以收到通知。 |
|
需要 PIN 才能获取连接上下文。 |
|
不会在设备中插入 SIM 卡。 |
|
设备中插入了错误的 SIM 卡。 |
|
设备不支持检索预配的上下文。 |
注解
连接上下文是一组特定网络配置参数的抽象，用于在第 2 层的物理移动宽带连接之上设置虚拟线路或流。 在 GSM 中，它对应于 PDP 上下文的概念;在 CDMA 中，它对应于网络配置文件。
在某些情况下，连接参数已在设备/SIM 内存中可用。 此方法可用于获取当前主提供商网络的设备中存储的连接上下文的列表。
仅应使用 MBN_CONTEXT_TYPE_INTERNET 类型的上下文进行数据连接。
设备将返回当前主提供程序的所有存储上下文。 某些上下文可以为空，它们将报告为 MBN_CONTEXT_TYPE_NONE。
有时，网络可以通过短信或 OTA 更新存储的预配上下文。 每当设备预配的上下文发生更改时，移动宽带服务都会调用 IMbnConnectionContextEvents 的 OnProvisionedContextListChange 方法。 然后，应用程序可以使用此方法获取已预配上下文的更新列表。
对于 E_MBN_PIN_REQUIRED、 E_MBN_SIM_NOT_INSERTED和 E_MBN_BAD_SIM的可恢复错误，移动宽带服务将在错误条件结束时再次查询设备以获取此信息。 例如，如果设备需要输入 PIN 才能检索连接上下文，则会返回 E_MBN_PIN_REQUIRED。 当应用程序输入 PIN 来解锁设备时，服务将再次尝试从设备获取此信息。 该服务将通过调用 IMbnConnectionContextEvents 的 OnProvisionedContextListChange 方法，更新有关新查询状态的应用程序。
要求
| 最低受支持的客户端 | Windows 7 [仅限桌面应用] |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | mbnapi.h |