通过

IMbnPinEvents：：OnUnblockComplete 方法 (mbnapi.h)

  • 项目

重要

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

移动宽带服务调用的通知方法，指示 PIN 取消阻止操作已完成

语法

HRESULT OnUnblockComplete(
  [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

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

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

值 含义
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 卡。

返回值

此方法必须返回 S_OK。

注解

移动宽带服务调用 OnUnblockComplete 方法，以报告通过调用 IMbnPin 的 Unblock 方法初始化的 PIN 取消阻止操作的完成状态。

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

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

如果设备无法取消阻止，并且 PUK 阻塞是 MBN_PIN_TYPE_PIN1 引脚，则还会导致设备的就绪状态更改为 MBN_READY_STATE_BAD_SIM。 将通过 IMbnInterfaceEvents 的 OnReadyStateChange 成员通知调用应用程序有关 ReadyState 更改。

要求

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

另请参阅

IMbnPinEvents