IMbnPin：：Unblock 方法 (mbnapi.h)

重要

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

取消阻止阻止的 PIN。

语法

HRESULT Unblock(
  [in]  LPCWSTR puk,
  [in]  LPCWSTR newPin,
  [out] ULONG   *requestID
);

[in] puk

此 PIN 类型的密码取消阻止密钥 (PUK) 值。

[in] newPin

要为此 PIN 类型设置的新 PIN。

[out] requestID

由移动宽带服务设置的请求 ID，用于标识此异步请求。

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

返回代码	说明
S_OK	该方法已成功完成。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)	移动宽带服务未在此系统上运行。
E_HANDLE	接口无效。移动宽带设备可能已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)	接口无效。很可能移动宽带设备已从系统中删除。
E_ACCESSDENIED	调用进程特权时不允许使用此方法。

Unblock 方法通过输入 PUK 来取消阻止 PIN 类型的 PIN，并设置新的 PIN。此 IMbnPin 的 PinType 属性表示正在更改的 PIN 类型。

这是一个异步操作。如果方法返回并成功，则在操作完成后，移动宽带服务将调用 IMbnPinEvents 的 OnUnblockComplete 方法。

每当 IMbnPinManager 的 GetPinState 方法导致当前 PIN 状态设置为MBN_PIN_STATE_UNBLOCK时，应用程序应对 PIN 类型使用 Unblock，该 PIN 类型由 IMbnPinManagerEvents 的 OnGetPinStateComplete 方法传递。

调用此方法需要管理员权限。