通过

IMbnPinManagerEvents：：OnGetPinStateComplete 方法 (mbnapi.h)

  • 项目

重要

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

移动宽带服务调用的通知方法指示完成由调用 IMbnPinManager 的 GetPinState 方法触发的异步操作。

语法

HRESULT OnGetPinStateComplete(
  [in] IMbnPinManager *pinManager,
  [in] MBN_PIN_INFO   pinInfo,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

parameters

[in] pinManager

指向 IMbnPinManager 接口的指针，该接口表示为其执行操作的移动宽带设备。

[in] pinInfo

包含设备 PIN 信息的 MBN_PIN_INFO 结构。

如果 pinInfo.pinState 设置为 MBN_PIN_STATE_NONE 则设备不会输入 PIN。

如果 pinInfo.pinState 设置为 MBN_PIN_STATE_ENTER 则设备需要输入 PIN， pinInfo.pinType 表示设备所需的 PIN 类型。

如果 pinInfo.pinState 设置为 MBN_PIN_STATE_UNBLOCK 则设备被 PIN 阻止，应尝试 PIN 取消阻止操作以取消阻止设备。 在这种情况下， pinInfo.pinType 表示应对其执行取消阻止操作的 PIN 类型。

如果 pinInfo.pinState 设置为 MBN_PIN_STATE_ENTER 或 MBN_PIN_STATE_UNBLOCK，则 pinInfo.attemptsRemaining 包含输入有效 PIN 或 PIN 取消阻止密钥 (PUK) 剩余的尝试次数。 如果剩余的尝试次数未知，则将 pinInfo.attemptsRemaining 设置为 MBN_ATTEMPTS_REMAINING_UNKNOWN。

[in] requestID

移动宽带服务分配用于标识此操作的请求 ID。

[in] status

操作完成状态。

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

值 含义
S_OK
 操作成功。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
设备不支持 PIN 操作。
E_MBN_SIM_NOT_INSERTED
 操作无法完成，因为设备中没有 SIM 卡。
E_MBN_BAD_SIM
 操作无法完成，因为设备中检测到错误的 SIM 卡。

返回值

此方法必须返回 S_OK。

注解

此方法由移动宽带服务调用，以通知应用程序完成由调用 IMbnPinManager 的 GetPinState 方法触发的异步操作。
成功完成后， pinInfo 包含设备预期下一个 PIN 的相关信息。

要求

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

另请参阅

IMbnPinManagerEvents