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;

Member

ContextId

Eine eindeutige ID für diesen Kontext.

Für festgelegte 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 Abfrage - OID_WWAN_PROVISIONED_CONTEXT-Anforderungen zurückgegeben werden.

ContextType

Gibt den Typ des dargestellten Kontexts an, z. B. Internetkonnektivität, VPN (eine Verbindung mit einem Unternehmensnetzwerk) oder Voice-over-IP (VOIP). Miniport-Treiber sollten WwanContextTypeNone für leere oder nicht bereitgestellte Kontexte angeben.

AccessString[WWAN_ACCESSSTRING_LEN]

Eine NULL-beendete Zeichenfolge für den Zugriff auf das Netzwerk. Für GSM-basierte Netzwerke wäre dies eine APN-Zeichenfolge (Access Point Name), z. B. "data.thephone-company.com". Bei CDMA-basierten Netzwerken kann dies eine spezielle Wählvorwahl wie "#777" oder eine Netzwerkzugriffs-ID (NAI) wie "foo@thephone-company.com" sein. Dieser Member 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. Dieser Member kann NULL sein.

Password[WWAN_PASSWORD_LEN]

Das Kennwort, das für die Authentifizierung verwendet werden soll. Dieser Member kann NULL sein.

Compression

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

AuthType

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

ProviderId[WWAN_PROVIDERID_LEN]

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 7 und späteren Windows-Versionen.
Kopfzeile	wwan.h (include Wwan.h)