OID_WWAN_PIN會設定或傳回與個人標識號 (PIN) 相關的資訊。
迷你埠驅動程序必須以異步方式處理設定和查詢要求,一開始傳回原始要求NDIS_STATUS_INDICATION_REQUIRED,並在完成設定或查詢要求時傳送 NDIS_STATUS_WWAN_PIN_INFO 狀態通知。
迷你埠驅動程式應該傳送 NDIS_STATUS_WWAN_PIN_INFO 狀態通知,其中包含 NDIS_WWAN_PIN_INFO 結構,以傳回 PIN 類型和 PIN 輸入狀態資訊,主要是指出完成查詢要求時是否需要 PIN 才能解除鎖定 MB 裝置或訂閱者身分識別模組(SIM 卡)。
要求設定 PIN 相關信息的呼叫端會提供迷你埠驅動程式的 NDIS_WWAN_SET_PIN 結構,以將 PIN 傳送至 MB 裝置、啟用或停用 PIN 設定,或變更 SIM 卡上的 PIN。
言論
如需使用此 OID 的詳細資訊,請參閱 WWAN Pin 作業。
Windows 7 迷你埠驅動程序應該使用 OID_WWAN_PIN。 Windows 8 迷你連接埠驅動程式應該使用 OID_WWAN_PIN_EX。
迷你埠驅動程式可以在處理查詢作業時存取「訂閱者識別模組」(SIM 卡),但不應該存取提供者網路。
在迷你埠驅動程式初始化程序期間,如果啟用 PIN1,MB 服務才會繼續註冊。
迷你埠驅動程式會在處理設定要求時,在 PinAction.Pin 成員中,提供使用者輸入 NDIS_WWAN_SET_PIN的 PIN 值。 只有在 PIN 值符合 SIM 卡中儲存的值時,迷你埠驅動程式才會處理要求。 否則,迷你埠驅動程序應該會因為狀態代碼WWAN_STATUS_FAILURE而使設定要求失敗。
CDMA 型裝置必須將電源裝置鎖定回報為 PIN1。
針對所有支援的 PIN 類型,迷你埠驅動程式必須支援 WwanPinOperationEnter 作業。 此外,如果支援 PIN1,迷你埠驅動程式必須支援 WwanPinOperationEnable、WwanPinOperationDisable,以及 WwanPinOperationChange 作業。
如果鎖定該 PIN 類型時嘗試 PIN 類型的 PIN 停用作業,迷你埠驅動程式可能會因為WWAN_STATUS_PIN_REQUIRED而失敗要求,也可以順利完成要求。 如果迷你埠驅動程式成功完成要求,停用作業也應該解除鎖定 PIN。
如果已啟用報告多個 PIN,而且一次只能報告一個 PIN,則迷你埠驅動程式應該先報告 PIN1。 例如,如果已啟用 SubsidyLock 和 SIM PIN1 的報告,則只有在 PIN1 成功驗證之後,才應該報告 SubsidyLock PIN(在後續的查詢要求中)。
除了 PIN1 之外,MB API 還支援其他 PIN。 不過,必須安裝第三方連接管理器/GUI,因為 Windows 連接管理器/GUI 僅支援 PIN1。
要求
版本 |
適用於 Windows 7 和更新版本的 Windows。 |
頁眉 |
Ntddndis.h (包括 Ndis.h) |