OID_WWAN_PIN
OID_WWAN_PIN會設定或傳回個人識別碼 (PIN) 的相關資訊。
迷你埠驅動程式必須以非同步方式處理設定和查詢要求,一開始將NDIS_STATUS_INDICATION_REQUIRED傳回原始要求,然後在完成設定或查詢要求時傳送 NDIS_STATUS_WWAN_PIN_INFO 狀態通知。
迷你埠驅動程式應該傳送包含NDIS_WWAN_PIN_INFO結構NDIS_STATUS_WWAN_PIN_INFO狀態通知,以傳回 PIN 類型和 PIN 輸入狀態資訊,主要是指出完成查詢要求時是否需要 PIN 才能解除鎖定 MB 裝置或訂閱者身分識別模組 (SIM 卡) 。
要求設定 PIN 相關資訊的呼叫者會提供 NDIS_WWAN_SET_PIN 結構給迷你埠驅動程式,以將 PIN 傳送至 MB 裝置、啟用或停用 PIN 設定,或變更 SIM 卡上的 PIN。
備註
如需使用此 OID 的詳細資訊,請參閱 WWAN 針腳作業 。
Windows 7 迷你埠驅動程式應該使用 OID_WWAN_PIN。 Windows 8迷你埠驅動程式應該使用OID_WWAN_PIN_EX。
迷你埠驅動程式可以在處理查詢作業時存取訂閱者身分識別模組 (SIM 卡) ,但不應該存取提供者網路。
在迷你埠驅動程式初始化程式期間,如果啟用,則 MB 服務不會繼續註冊,直到 PIN1 成功解除鎖定為止。
迷你埠驅動程式會在處理設定要求時,在 NDIS_WWAN_SET_PIN 結構的 PinAction.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。 例如,如果已啟用一般訊息鎖定和 SIM PIN1 的報告,則只有在成功驗證 PIN1 之後,才會在後續查詢) 要求中報告 ( (。
MB API 除了 PIN1 之外,還支援其他 PIN。 不過,必須安裝協力廠商連線管理員/GUI,因為 Windows 連線管理員/GUI 僅支援 PIN1。
規格需求
版本 |
適用于 Windows 7 和更新版本的 Windows。 |
標頭 |
Ntddndis.h (包含 Ndis.h) |