WWAN_PROVIDER-Struktur (wwan.h)
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 | |
|
WWAN_PROVIDER_STATE_FORBIDDEN WWAN_PROVIDER_STATE_PREFERRED |
|
|
WWAN_PROVIDER_STATE_VISIBLE WWAN_PROVIDER_STATE_REGISTERED WWAN_PROVIDER_STATE_HOME WWAN_PROVIDER_STATE_PREFERRED WWAN_PROVIDER_STATE_FORBIDDEN |
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) |