IMbnConnectionContextEvents：：OnSetProvisionedContextComplete 方法 (mbnapi.h)

  • 项目

重要

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

移动宽带服务调用的通知方法，指示已设置设备中的预配上下文。

语法

HRESULT OnSetProvisionedContextComplete(
  [in] IMbnConnectionContext *newInterface,
  [in] ULONG                 requestID,
  [in] HRESULT               status
);

参数

[in] newInterface

表示为其设置了上下文的设备的 IMbnConnectionContext 接口。

[in] requestID

由移动宽带服务设置的请求 ID，用于标识设置上下文的操作。

[in] status

指示操作结果的状态代码。

调用应用程序可能需要以下值之一。

值 含义
S_OK
 操作成功。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
设备不支持此操作。
E_MBN_PIN_REQUIRED
 需要 PIN 才能完成操作。
E_INVALIDARG
 请求中提供的上下文 ID 或提供程序 ID 无效。
E_MBN_BAD_SIM
 设备中有一个错误的 SIM 卡。
HRESULT_FROM_WIN32 (ERROR_WRITE_FAULT)
SIM 卡或设备内存中的更新失败。

返回值

此方法必须返回 S_OK。

注解

调用应用程序可以将 IMbnConnectionContext 接口传递给 newInterface ，以获取设备中预配上下文的更新列表。 但是，由于此操作是异步的，因此在使用此接口获取上下文之前，应用程序必须等待 OnProvisionedContextListChange 通知。

如果注册了多个应用程序以接收通知，则所有应用程序都将收到此通知，即使其中只有一个应用程序可以启动此操作。

要求

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

另请参阅

IMbnConnectionContextEvents