IMbnPinManager：：GetPinState 方法 (mbnapi.h)

重要

從 Windows 10 1803 版開始，本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。

取得裝置目前的 PIN 狀態。

語法

HRESULT GetPinState(
  [out] ULONG *requestID
);

[out] requestID

此非同步要求之行動寬頻服務所設定之要求識別碼的指標。回應會包含相同的要求識別碼。

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

傳回碼	描述
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方法。