WWAN_CONTEXT-Struktur (wwan.h)

Artikel
02/27/2024

Die WWAN_CONTEXT-Struktur stellt einen bereitgestellten Kontext dar, der vom MB-Gerät unterstützt wird.

Syntax

typedef struct _WWAN_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;
} WWAN_CONTEXT, *PWWAN_CONTEXT;

Member

ContextId

Eine eindeutige ID für diesen Kontext.

Beim 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 sollten niemals als Antwort auf Abfragen OID_WWAN_PROVISIONED_CONTEXT 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). Miniporttreiber 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. 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 Vorwahlnummer wie "#777" oder ein Network Access Identifier (NAI) wie "foo@thephone-company.com" sein. Dieses Element kann NULL sein.

Die Größe der Zeichenfolge sollte 100 Bytes 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 diesen Member für CDMA-basierte Geräte auf WwanCompressionNone fest.

AuthType

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