OID_WWAN_PROVISIONED_CONTEXTS
OID_WWAN_PROVISIONED_CONTEXTS läser eller uppdaterar de etablerade kontextposterna som lagras på MB-enheten eller sim-modulen (Subscriber Identity Module).
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_PROVISIONED_CONTEXTS statusmeddelande som innehåller en NDIS_WWAN_PROVISIONED_CONTEXTS struktur för att tillhandahålla information om etablerade kontextposter som lagras på MB-enheten eller sim-modulen (Subscriber Identity Module) oavsett om du slutför uppsättnings- eller frågebegäranden.
Anmärkningar
Mer information om hur du använder denna OID finns i WWAN Packet Context Management.
Miniportdrivrutiner bör returnera NDIS_STATUS_NOT_SUPPORTED om MB-enheten som de stöder inte stöder hämtning av etablerade kontexter.
GSM-baserade enheter kan eventuellt ha stöd för fråge- och uppsättningsåtgärder. CDMA-baserade enheter kan eventuellt ha stöd för frågeåtgärder som rapporterar enkel IP-adress (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP).
De etablerade kontextposterna som lagras på MB-enheten eller SIM-kortet är lokala för enheten. Miniportdrivrutiner bör inte ansluta till nätverket för att läsa i dessa fält.
Indatastrukturen för en uppsättningsbegäran är NDIS_WWAN_SET_PROVISIONED_CONTEXT och statusindikeringen för det här objektet är NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS.
Etablerade kontexter är inte samma som för GPRS-kontextdefinitionerna i 3GPP som cachelagrar listan över API:er. Etablerade kontexter är anslutningsparametrarna (AccessString, UserName och Password) som antingen är företablerade av operatorerna eller OTA som tillhandahålls av enheten och kan lagras i enhetens minne eller SIM. Anslutningsparametrarna som returneras av etablerade kontexter används av MB-tjänsten för PDP-aktivering.
Både fråge- och uppsättningsformen för det här objektet används.
Bearbetning av den här begäran kräver inte nätverksåtkomst, men kräver åtkomst till SIM-kortet eller extra minne på MB-enheten.
Miniportdrivrutinen skickar NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS meddelande till operativsystemet. Medlemmen ContextListHeader.ElementType ska anges till WwanStructContext. Miniportdrivrutinen bör ange ContextListHeader.ElementCount medlem till 0 när meddelandet skickas som svar på en angivet begäran.
MB-tjänsten bör hämta listan över etablerade kontexter från enheten innan du utför någon enskild kontextaktivering eller inaktivering. Listan över etablerade kontexter får endast begränsas till hemprovidernätverket, även om enheten kan ha möjlighet att lagra flera nätverksproviderkontexter. Kontextlistan måste alltid vara det hemleverantörsnätverk som är specifikt även vid roaming.
SET OID_WWAN_PROVISIONED_CONTEXT-åtgärden ska associera kontexten med den nätverksprovider som anges i den angivna begäran i ProviderId medlem i WWAN_SET_CONTEXT-strukturen. Etablerad kontext som lagras via uppsättning OID_WWAN_PROVISIONED_CONTEXT begäranden måste bevaras mellan systemomstarter och återanvändning av enhetskraft.
Alla tomma kontexter måste rapporteras i en fråga tillsammans med de etablerade kontexter som gäller för hemprovidernätverket.
CDMA-enheter som är konfigurerade för SimpleIP, rapportering i WWAN_CTRL_CAPS_CDMA_SIMPLE_IP i WwanControlCaps kan eventuellt returnera minst en etablerad kontext fylld med rätt AccessString, UserNameoch Lösenord medlemmar för frågebegäran från MB Service.
En etablerad kontextlista bör vara företablerad på enheten, uppdateras efter uppsättning OID_WWAN_PROVISIONED_CONTEXT åtgärder eller uppdateras av enhet/operatör med SMS eller OTA. Den får inte uppdateras dynamiskt baserat på den kontextinformation som tillhandahålls i den OID_WWAN_CONNECT åtgärden av MB-tjänsten.
Mer information om hur du kommer åt AccessString, UserName och Lösenord från MB-enheten för varje etablerad kontext i listan finns i WWAN_CONTEXT.
Krav
Version |
Finns i Windows 7 och senare versioner av Windows. |
Rubrik |
Ntddndis.h (inkludera Ndis.h) |