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 才能完成操作。 调用应用程序可以调用 IMbnPinManagerGetPinState 方法,以发现预期的 PIN 的类型。
E_MBN_SIM_NOT_INSERTED
设备中没有 SIM 卡。
E_MBN_BAD_SIM
设备中有一个错误的 SIM 卡。

返回值

此方法必须返回 S_OK

注解

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

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

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

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

要求

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

另请参阅

IMbnPinEvents