OID_WWAN_PIN
OID_WWAN_PIN anger eller returnerar information som rör personliga identifieringsnummer (PIN-koder).
Miniportdrivrutiner måste bearbeta uppsättnings- och frågebegäranden asynkront, först returnera NDIS_STATUS_INDICATION_REQUIRED till den ursprungliga begäran och senare skicka ett NDIS_STATUS_WWAN_PIN_INFO statusmeddelande när de har slutfört uppsättningen eller frågebegäran.
Miniportdrivrutiner bör skicka NDIS_STATUS_WWAN_PIN_INFO statusmeddelanden som innehåller en NDIS_WWAN_PIN_INFO struktur för att returnera INFORMATION om PIN-typ och PIN-inmatningstillstånd, främst för att ange om en PIN-kod krävs för att låsa upp MB-enheten eller SIM-kortet (Subscriber Identity Module) när du slutför frågeförfrågningar.
Uppringare som begär att ange information om PIN-koder tillhandahåller en NDIS_WWAN_SET_PIN struktur för miniportdrivrutinen för att skicka en PIN-kod till MB-enheten, aktivera eller inaktivera PIN-inställningarna eller ändra en PIN-kod på SIM-kortet.
Anmärkningar
Mer information om hur du använder denna OID finns i WWAN Pin Operations.
Windows 7-miniportdrivrutiner bör använda OID_WWAN_PIN. Windows 8 miniport-drivrutiner bör använda OID_WWAN_PIN_EX.
Miniportdrivrutiner kan komma åt sim-kortet (Subscriber Identity Module) när du bearbetar frågeåtgärder, men bör inte komma åt providernätverket.
Under initieringsprocessen för miniportdrivrutinen fortsätter MB-tjänsten inte till registreringen förrän PIN1 har låsts upp, om den är aktiverad.
Miniportdrivrutiner ger ett PIN-kodsvärde som anges av slutanvändaren i PinAction.Pin medlem i NDIS_WWAN_SET_PIN-strukturen vid bearbetning av begäranden. Endast när PIN-värdet matchar värdet som lagras i SIM-kortet ska begäran bearbetas av miniportdrivrutinen. I annat fall bör miniportdrivrutiner misslyckas med den angivna begäran med statuskod WWAN_STATUS_FAILURE.
CDMA-baserade enheter måste rapportera det aktiverade enhetslåset som PIN1.
För alla PIN-kodstyper som stöds måste miniportdrivrutiner stödja åtgärden WwanPinOperationEnter. Om PIN1 stöds måste miniportdrivrutiner dessutom ha stöd för WwanPinOperationEnable, WwanPinOperationDisableoch WwanPinOperationChange åtgärder.
Om en PIN-inaktiveringsåtgärd för en PIN-kodstyp provas när pin-kodstypen är låst kan miniportdrivrutiner antingen misslyckas med begäran med WWAN_STATUS_PIN_REQUIRED eller så kan de slutföra begäran. Om miniportdrivrutinen slutför begäran bör inaktivera-åtgärden också låsa upp PIN-koden.
Om rapportering av flera PIN-koder är aktiverade och endast en PIN-kod kan rapporteras i taget förväntas miniportdrivrutiner rapportera PIN1 först. Om till exempel rapportering av SubsidyLock och SIM PIN1 är aktiverade ska SubsidyLock PIN-koden rapporteras (i en efterföljande frågebegäran) först efter att PIN-koden 1 har verifierats.
MB-API:et stöder andra PIN-koder utöver PIN1. En anslutningshanterare/guid från tredje part måste dock installeras eftersom Windows Anslutningshanterare/GUI endast stöder PIN1.
Krav
Version |
Finns i Windows 7 och senare versioner av Windows. |
Rubrik |
Ntddndis.h (inkludera Ndis.h) |