WWAN_SET_CONTEXT Struktur (wwan.h)

Die WWAN_SET_CONTEXT-Struktur stellt einen bereitgestellten Kontext mit einer Netzwerkanbieteridentifikation dar, die vom MB-Gerät unterstützt wird.

Syntax

typedef struct _WWAN_SET_CONTEXT {
  ULONG              ContextId;
  WWAN_CONTEXT_TYPE  ContextType;
  WCHAR              AccessString[WWAN_ACCESSSTRING_LEN];
  WCHAR              UserName[WWAN_USERNAME_LEN];
  WCHAR              Password[WWAN_PASSWORD_LEN];
  WWAN_COMPRESSION   Compression;
  WWAN_AUTH_PROTOCOL AuthType;
  WCHAR              ProviderId[WWAN_PROVIDERID_LEN];
} WWAN_SET_CONTEXT, *PWWAN_SET_CONTEXT;

Angehörige

ContextId

Eine eindeutige ID für diesen Kontext.

Für festlegen OID_WWAN_PROVISIONED_CONTEXT Anforderungen kann der MB-Dienst den Wert auf WWAN_CONTEXT_ID_APPEND festlegen. Wenn dieser Wert verwendet wird, sollte der Miniporttreiber den Index zum Speichern der Kontextinformationen festlegen. WWAN_CONTEXT_ID_APPEND sollte niemals als Reaktion auf Abfrageanforderungen OID_WWAN_PROVISIONED_CONTEXT zurückgegeben werden.

ContextType

Gibt den Kontexttyp an, der dargestellt wird, z. B. Internetkonnektivität, VPN (eine Verbindung mit einem Unternehmensnetzwerk) oder VoIP (Voice-over-IP). Miniport-Treiber sollten WwanContextTypeNone- für leere oder nicht bereitgestellte Kontexte angeben.

AccessString[WWAN_ACCESSSTRING_LEN]

Eine MIT NULL beendete Zeichenfolge für den Zugriff auf das Netzwerk. Bei GSM-basierten Netzwerken wäre dies eine APN-Zeichenfolge (Access Point Name), z. B. "data.thephone-company.com". Bei CDMA-basierten Netzwerken kann dies eine spezielle Wählnummer wie "#777" oder ein Network Access Identifier (NAI) wie "foo@thephone-company.com" sein. Dieses Element kann NULL-sein.

Die Größe der Zeichenfolge darf 100 Byte nicht überschreiten.

UserName[WWAN_USERNAME_LEN]

Der benutzername, der für die Authentifizierung verwendet werden soll. Dieses Element kann NULL-sein.

Password[WWAN_PASSWORD_LEN]

Das kennwort, das für die Authentifizierung verwendet werden soll. Dieses Element kann NULL-sein.

Compression

Gibt die Komprimierung an, die in der Datenverbindung für Header und Daten verwendet werden soll. Dieses Mitglied gilt nur für GSM-basierte Geräte. Der MB-Dienst legt dieses Mitglied auf WwanCompressionNone- für CDMA-basierte Geräte fest.

AuthType

Authentifizierungstyp, der für die PDP-Aktivierung verwendet werden soll.

ProviderId[WWAN_PROVIDERID_LEN]

Eine MIT NULL beendete Zeichenfolge, die die Netzwerkanbieteridentifikation darstellt, für die der bereitgestellte Kontext in OID_WWAN_PROVISIONED_CONTEXT Anforderungen gespeichert werden soll. Miniport-Treiber sollten den hinzugefügten bereitgestellten Kontext als Reaktion auf nachfolgende Abfrage Vorgänge zurückgeben, wenn sich ein Abonnentenidentitätsmodul (SIM-Karte) mit dieser Heimanbieter-ID im Gerät befindet.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 7 und höheren Versionen von Windows.
Header-	wwan.h (include Wwan.h)