IMbnConnectionContext：：SetProvisionedContext 方法 (mbnapi.h)

重要

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

添加或更新预配的上下文。

语法

HRESULT SetProvisionedContext(
  [in]  MBN_CONTEXT provisionedContexts,
  [in]  LPCWSTR     providerID,
  [out] ULONG       *requestID
);

[in] provisionedContexts

指定要存储在设备或 SIM 中的预配上下文的 MBN_CONTEXT 结构。

[in] providerID

一个字符串，表示应存储其预配上下文的网络提供程序 ID。当具有此主提供商 ID 的 SIM 卡位于设备中时，设备应返回添加的预配上下文，以响应任何后续查询。

[out] requestID

由移动宽带服务设置的请求 ID，用于标识此异步请求。

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

返回代码	说明
S_OK	该方法已成功完成。
E_HANDLE	接口无效。移动宽带设备很可能已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)	接口无效。移动宽带设备很可能已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)	移动宽带服务未在此系统上运行。
E_INVALID_ARG	providerID 无效。

provisionedContexts 的 contextID 指定要在其中存储上下文的设备或 SIM 内存中的索引。如果设置为 MBN_CONTEXT_ID_APPEND，则设备应找到适当的索引来存储上下文。

这是一个异步操作， SetProvisionedContext 将立即返回。操作完成后，移动宽带服务将通过调用 IMbnConnectionContextEvents 的 OnSetProvisionedContextComplete 方法通知应用程序。

在调用 IMbnConnectionContextEvents 的 OnProvisionedContextListChange 方法之前，当前主提供程序 ID 的预配上下文列表的新增内容将不能用于查询。