WWAN_PROVIDER-Struktur (wwan.h)

  • Artikel

Die WWAN_PROVIDER-Struktur stellt Details zu einem Netzwerkanbieter dar.

Syntax

typedef struct _WWAN_PROVIDER {
  WCHAR ProviderId[WWAN_PROVIDERID_LEN];
  ULONG ProviderState;
  WCHAR ProviderName[WWAN_PROVIDERNAME_LEN];
  ULONG WwanDataClass;
} WWAN_PROVIDER, *PWWAN_PROVIDER;

Member

ProviderId[WWAN_PROVIDERID_LEN]

Eine NULL-beendete numerische Zeichenfolge (0-9), die die Identität des Netzwerkanbieters darstellt.

Bei GSM-basierten Netzwerken ist diese Zeichenfolge eine Verkettung aus einem dreistelligen Mobile Country Code (MCC) und einem zwei- oder dreistelligen Mobilfunkcode (MNC). GSM-basierte Carrier können über mehr als einen MNC und daher über mehrere ProviderId verfügen.

Bei CDMA-basierten Netzwerken ist diese Zeichenfolge eine fünfstellige System-ID (SID). In der Regel verfügt ein CDMA-basierter Carrier über mehr als eine SID. In der Regel verfügt die Fluggesellschaft über eine SID für jeden Markt, die in der Regel geografisch innerhalb einer Nation durch Vorschriften unterteilt ist, wie z. B. Metropolitan Statistical Areas (MSA) in der USA von Amerika. Miniporttreiber von CDMA-basierten Geräten müssen WWAN_CDMA_DEFAULT_PROVIDER_ID angeben, wenn diese Informationen nicht verfügbar sind.

ProviderState

Ein Wert, der die verschiedenen Zustände darstellt, mit denen der Eintrag des Netzwerkanbieters markiert werden kann. Die folgende Tabelle zeigt die möglichen Werte, die Miniporttreiber angeben sollten (mindestens ein Wert kann angegeben werden).

Wert Bedeutung
WWAN_PROVIDER_STATE_HOME Der Netzwerkanbieter ist der Heimbetreiber.
WWAN_PROVIDER_STATE_FORBIDDEN Der Netzbetreiber befindet sich auf der Verbotenen Liste.
WWAN_PROVIDER_STATE_PREFERRED Der Netzwerkanbieter befindet sich in der bevorzugten Liste.
WWAN_PROVIDER_STATE_VISIBLE Der Netzwerkanbieter ist sichtbar.
WWAN_PROVIDER_STATE_REGISTERED Der Netzwerkanbieter ist derzeit vom Gerät registriert.
WWAN_PROVIDER_STATE_UNKNOWN Der Netzwerkanbieterstatus ist unbekannt.
 

Einige Werte in der vorherigen Tabelle gelten nur für bestimmte Objektbezeichner (OIDs). Die folgende Tabelle zeigt die Zuordnungen zwischen diesen Werten und zugehörigen OIDs.

Wert OID
WWAN_PROVIDER_STATE_HOME

OID_WWAN_HOME_PROVIDER
WWAN_PROVIDER_STATE_FORBIDDEN

WWAN_PROVIDER_STATE_PREFERRED

OID_WWAN_PREFERRED_PROVIDERS
WWAN_PROVIDER_STATE_VISIBLE

WWAN_PROVIDER_STATE_REGISTERED

WWAN_PROVIDER_STATE_HOME

WWAN_PROVIDER_STATE_PREFERRED

WWAN_PROVIDER_STATE_FORBIDDEN

OID_WWAN_VISIBLE_PROVIDERS

ProviderName[WWAN_PROVIDERNAME_LEN]

Eine NULL-beendete Zeichenfolge, die den Namen des Netzwerkanbieters darstellt. Dieser Member ist auf höchstens WWAN_PROVIDERNAME_LEN Zeichen beschränkt.

Wenn bei GSM-basierten Netzwerken die bevorzugte Präsentation von Länderinitials und Mobilfunknetzname (PPCI&N) länger als WWAN_PROVIDERNAME_LEN Zeichen ist, sollte der Miniporttreiber den Netzwerknamen kürzen.

Dieser Member wird ignoriert, wenn der MB-Dienst die Liste der bevorzugten Anbieter festlegt.

Miniport-Treiber sollten eine NULL-Zeichenfolge für Geräte angeben, die nicht über diese Informationen verfügen.

WwanDataClass

Eine Bitmap, die die vom Gerät unterstützten Datenklassen darstellt. Eine detaillierte Liste der Werte finden Sie im WwanDataClass-Member von WWAN_DEVICE_CAPS.

Dieses Element kann ignoriert werden, wenn nach OID_WWAN_HOME_PROVIDER abgefragt wird.

Anforderungen

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

Weitere Informationen

NDIS_WWAN_HOME_PROVIDER

NDIS_WWAN_PREFERRED_PROVIDERS

NDIS_WWAN_VISIBLE_PROVIDERS

WWAN_DEVICE_CAPS