IMbnPinManager::GetPinState 方法 (mbnapi.h)
重要
從 Windows 10 1803 版開始,本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。
取得裝置目前的 PIN 狀態。
語法
HRESULT GetPinState(
[out] ULONG *requestID
);
參數
[out] requestID
此非同步要求之行動寬頻服務所設定之要求識別碼的指標。 回應會包含相同的要求識別碼。
傳回值
這個方法可以傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
|
已成功完成命令。 |
|
行動寬頻服務未在此系統上執行。 |
|
介面無效,很可能是因為行動寬頻裝置已從系統中移除。 |
|
介面無效。 很可能已從系統移除行動寬頻裝置。 |
備註
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方法。
需求
最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | mbnapi.h |