IMbnPinManager：：GetPinState 方法 (mbnapi.h)

重要

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

获取设备的当前 PIN 状态。

语法

HRESULT GetPinState(
  [out] ULONG *requestID
);

[out] requestID

指向移动宽带服务为此异步请求设置的请求 ID 的指针。响应将包含相同的请求 ID。

此方法可以返回其中一个值。

返回代码	说明
S_OK	该方法已成功完成。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)	移动宽带服务未在此系统上运行。
E_HANDLE	接口无效，很可能是因为移动宽带设备已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)	接口无效。移动宽带设备很可能已从系统中删除。

GetPinState 方法针对设备的 PIN 状态启动异步请求。 PIN 状态指示是否需要输入 PIN 才能完成请求的操作。它还包含设备需要哪种类型的 PIN 的信息，并根据需要提供输入有效 PIN 的剩余尝试次数。

此方法始终返回设备的当前 PIN 状态。创建此对象时，它不会缓存 PIN 状态。相反，它始终与设备联系，并返回设备的当前 PIN 状态。

由于这是一个异步操作， GetPinState 将立即返回。操作完成后，移动宽带服务将调用 IMbnPinManagerEvents 的 OnGetPinStateComplete 方法。

每当操作返回 E_MBN_PIN_REQUIRED 或设备报告的就绪状态 MBN_READY_STATE_DEVICE_LOCKED时，应用程序都应使用此方法查询解锁设备或 SIM 卡所需的 PIN 类型。

此操作正在进行中，如果移动宽带设备从系统中删除，则无法保证调用 IMbnPinManagerEvents 的 OnGetPinStateComplete 方法。