OID_WWAN_PROVISIONED_CONTEXTS
OID_WWAN_PROVISIONED_CONTEXTS liest oder aktualisiert die bereitgestellten Kontexteinträge, die auf dem MB-Gerät oder dem Subscriber Identity Module (SIM) gespeichert sind.
Miniport-Treiber müssen Set- und Abfrageanforderungen asynchron verarbeiten, zunächst NDIS_STATUS_INDICATION_REQUIRED an die ursprüngliche Anforderung zurückgeben und später eine NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS status Benachrichtigung senden, die eine NDIS_WWAN_PROVISIONED_CONTEXTS Struktur enthält, um Informationen zu bereitgestellten Kontexteinträgen bereitzustellen, die auf dem MB-Gerät oder dem Abonnentenidentitätsmodul (Subscriber Identity Module, SIM) gespeichert sind, unabhängig vom Abschluss von Set- oder Abfrageanforderungen.
Bemerkungen
Weitere Informationen zur Verwendung dieser OID finden Sie unter WWAN-Paketkontextverwaltung.
Miniport-Treiber sollten NDIS_STATUS_NOT_SUPPORTED zurückgeben, wenn das von ihnen unterstützte MB-Gerät den Abruf bereitgestellter Kontexte nicht unterstützt.
GSM-basierte Geräte können optional Abfragen und Festlegen von Vorgängen unterstützen. CDMA-basierte Geräte können optional Abfragevorgänge unterstützen, die simple IP (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP) melden.
Die bereitgestellten Kontexteinträge, die auf dem MB-Gerät oder der SIM gespeichert sind, sind lokal für das Gerät. Miniporttreiber sollten keine Verbindung mit dem Netzwerk herstellen, um diese Felder zu lesen.
Die Eingabestruktur für eine Setanforderung ist NDIS_WWAN_SET_PROVISIONED_CONTEXT, und status Angabe dieses Objekts ist NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS.
Bereitgestellte Kontexte sind nicht mit den GPRS-Kontextdefinitionen in 3GPP identisch, die die Liste der APNs zwischenspeichern. Bereitgestellte Kontexte sind die Konnektivitätsparameter (AccessString, Benutzername und Kennwort), die entweder von den Operatoren vorab bereitgestellt werden oder vom Gerät bereitgestellte OTA und entweder im Gerätespeicher oder im SIM gespeichert werden können. Die von den bereitgestellten Kontexten zurückgegebenen Konnektivitätsparameter werden vom MB-Dienst für die PDP-Aktivierung verwendet.
Es wird sowohl abfrage- als auch festgelegte Form dieses Objekts verwendet.
Die Verarbeitung dieser Anforderung erfordert keinen Netzwerkzugriff, erfordert jedoch Zugriff auf die SIM-Karte oder den zusätzlichen Arbeitsspeicher auf dem MB-Gerät.
Der Miniporttreiber sendet NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS Benachrichtigung an das Betriebssystem. Das ContextListHeader.ElementType-Member muss auf WwanStructContext festgelegt werden. Der Miniport-Treiber sollte den ContextListHeader.ElementCount-Member auf 0 festlegen, wenn eine Benachrichtigung als Reaktion auf eine festgelegte Anforderung gesendet wird.
Der MB-Dienst sollte die Liste der bereitgestellten Kontexte vom Gerät abrufen, bevor er eine einzelne Kontextaktivierung oder -deaktivierung durchführt. Die Liste der bereitgestellten Kontexte darf nur auf das Heimanbieternetzwerk beschränkt sein, obwohl das Gerät möglicherweise die Möglichkeit hat, mehrere Netzwerkanbieterkontexte zu speichern. Die Kontextliste muss immer das netzwerkspezifische Heimanbieter sein, auch bei Roaming.
SET OID_WWAN_PROVISIONED_CONTEXT Vorgang sollte den Kontext dem Netzwerkanbieter zuordnen, der in der Setanforderung im ProviderId-Member der WWAN_SET_CONTEXT-Struktur angegeben ist. Bereitgestellter Kontext, der über festgelegte OID_WWAN_PROVISIONED_CONTEXT Anforderungen gespeichert wird, muss über Systemneustarts und Gerätestromrecyclings hinweg beibehalten werden.
Alle leeren Kontexte müssen zusammen mit den bereitgestellten Kontexten, die für das Heimanbieternetzwerk gelten, für eine Abfrage gemeldet werden.
CDMA-Geräte, die für SimpleIP konfiguriert sind und in WWAN_CTRL_CAPS_CDMA_SIMPLE_IP in WwanControlCaps berichtigen, können optional mindestens einen bereitgestellten Kontext zurückgeben, der mit den richtigen AccessString-, UserName- und Password-Membern für die Abfrageanforderung von MB Service gefüllt ist.
Die bereitgestellte Kontextliste sollte auf dem Gerät vorab bereitgestellt, durch Festlegen OID_WWAN_PROVISIONED_CONTEXT Vorgänge aktualisiert oder vom Gerät/Betreiber mithilfe von SMS oder OTA aktualisiert werden. Es darf nicht dynamisch aktualisiert werden, basierend auf den Kontextinformationen, die im OID_WWAN_CONNECT-Vorgang von MB Service bereitgestellt werden.
Weitere Informationen zum Zugreifen auf AccessString, UserName und Password vom MB-Gerät für jeden bereitgestellten Kontext in der Liste finden Sie unter WWAN_CONTEXT.
Requirements (Anforderungen)
Version |
Verfügbar in Windows 7 und späteren Windows-Versionen. |
Header |
Ntddndis.h (include Ndis.h) |