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

行動寬頻服務所設定的要求標識碼，用來識別此異步要求。

這個方法可以傳回其中一個值。

傳回碼	描述
S_OK	已成功完成命令。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)	行動寬頻服務未在此系統上執行。
E_HANDLE	無效的介面。行動寬頻裝置可能已從系統中移除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)	無效的介面。最有可能是行動寬頻裝置已從系統中移除。
E_ACCESSDENIED	這個方法不允許呼叫進程許可權。

解除封鎖方法會輸入PUK並設定新的PIN，以解除封鎖 PIN 類型的 PIN。這個 IMbnPin 的 PinType 屬性代表正在變更的 PIN 類型。

這是一個非同步作業。如果方法傳回成功，則當作業完成時，行動寬頻服務會呼叫IMbnPinEvents的 OnUnblockComplete 方法。

每當 IMbnPinManager 的 GetPinState 方法產生目前 PIN 狀態設定為 MBN_PIN_STATE_UNBLOCK時，應用程式應該在 PIN 類型上使用 Unblock，此類型會在IMbnPinManagerEvents 的 OnGetPinStateComplete 方法中傳回。

叫用此方法需要系統管理員許可權。