通过

IMbnPinEvents：：OnChangeComplete 方法 (mbnapi.h)

  • 项目

重要

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

移动宽带服务调用的通知方法，指示 PIN 更改操作已完成。

语法

HRESULT OnChangeComplete(
  [in] IMbnPin      *Pin,
  [in] MBN_PIN_INFO *pinInfo,
  [in] ULONG        requestID,
  [in] HRESULT      status
);

parameters

[in] Pin

表示 PIN 类型的 IMbnPin 接口。

[in] pinInfo

指向 MBN_PIN_INFO 结构的指针，该结构包含有关失败操作的剩余尝试的信息。 仅当状态为E_MBN_FAILURE时，pinInfo 的内容才有意义。

[in] requestID

由移动宽带服务设置的请求 ID，用于标识 PIN 更改请求。

[in] status

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

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

值 含义
S_OK
 操作成功。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
设备不支持此操作。
E_FAIL
 操作无法完成。
E_MBN_PIN_REQUIRED
 需要 PIN 才能完成操作。 调用应用程序可以调用 IMbnPinManager 的 GetPinState 方法，以发现预期的 PIN 类型。
E_MBN_SIM_NOT_INSERTED
 设备中没有 SIM 卡。
E_MBN_BAD_SIM
 设备中有错误的 SIM 卡。
E_MBN_PIN_DISABLED
 禁用的 PIN 不支持 PIN 更改操作。

返回值

此方法必须返回 S_OK。

注解

移动宽带服务调用 OnChangeComplete 方法，以报告通过调用 IMbnPin 的 Change 方法初始化的 PIN 更改操作的完成状态。

仅当状态为E_MBN_FAILURE时，pinInfo 的内容才有意义。 应忽略 pinState 成员，并将 pinType 字段设置为当前 IMbnPin 接口的 PIN 类型。 此结构包含剩余的输入有效 PIN 的尝试。

例如，如果传递用于更改 PIN 类型的 PIN 不正确，则操作将失败，状态代码 为 E_MBN_FAILURE。 在这种情况下， pinInfo.attemptsRemaining 指定重试此操作的剩余尝试次数。 如果 PIN 错误的重复尝试导致 attemptsRemaining 变为 0，则应用程序可以调用 IMbnPinManager 的 GetPinState 方法以获取所需的 PIN 类型。

要求

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

另请参阅

IMbnPinEvents