IMbnPinManager::GetPinList 方法 (mbnapi.h)
重要
從 Windows 10 1803 版開始,本節所述的 Win32 API 會由 Windows.Networking.Connectivity 命名空間中的 Windows 執行階段 API 取代。
取得裝置支援的不同 PIN 類型清單。
語法
HRESULT GetPinList(
[out, retval] SAFEARRAY **pinList
);
參數
[out, retval] pinList
代表裝置所支援 PIN 類型的 MBN_PIN_TYPE 值清單指標。 當 GetPinList 傳回 S_OK以外的任何專案時, pinList 為 NULL,否則呼叫的應用程式必須呼叫 SafeArrayDestroy 來釋放配置的記憶體。
傳回值
這個方法可以傳回其中一個值。
傳回碼 | 描述 |
---|---|
|
已成功完成命令。 |
|
PIN 類型無法使用。 行動寬頻服務目前正在探查裝置以取得資訊。 當 PIN 類型可供使用時,行動寬頻服務會呼叫 IMbnPinManagerEvents 的 OnPinListAvailable 方法。 |
|
裝置需要輸入 PIN 才能進行這項作業。 |
|
不會插入 SIM 卡。 |
|
在裝置中插入不正確的 SIM 卡。 |
備註
在可復原的錯誤 E_MBN_PIN_REQUIRED、 E_MBN_SIM_NOT_INSERTED和 E_MBN_BAD_SIM上,行動寬頻服務會在錯誤狀況結束時嘗試從裝置擷取此資訊。 擷取此資訊時 ,GetPinList 呼叫將會傳回 E_PENDING。 擷取作業完成後,行動寬頻服務會呼叫IMbnPinManagerEvents的 OnPinListAvailable 方法。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | mbnapi.h |