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;
Angehörige
ProviderId[WWAN_PROVIDERID_LEN]
Eine mit NULL beendete numerische Zeichenfolge (0-9), die die Identität des Netzwerkanbieters darstellt.
Bei GSM-basierten Netzwerken handelt es sich bei dieser Zeichenfolge um eine Verkettung einer dreistelligen Landeskennzahl (Mobile Country Code, MCC) und eines zwei- oder dreistelligen Mobilfunknetzcodes (MNC). GSM-basierte Netzbetreiber können mehr als einen MNC haben und daher mehr als eine ProviderId .
Bei CDMA-basierten Netzwerken ist diese Zeichenfolge eine fünfstellige System-ID (SID). Im Allgemeinen verfügt ein CDMA-basierter Netzbetreiber über mehr als eine SID. In der Regel verfügt der Netzbetreiber über eine SID für jeden Markt, der in der Regel geografisch innerhalb einer Nation durch Vorschriften unterteilt wird, z. B. Metropolitan Statistical Areas (MSA) in den VEREINIGTEN Staaten 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. In der folgenden Tabelle sind die möglichen Werte aufgeführt, die Miniporttreiber angeben sollten (mindestens ein Wert kann angegeben werden).
| Wert | Bedeutung |
|---|---|
| WWAN_PROVIDER_STATE_HOME | Der Netzwerkanbieter ist der Heimnetzbetreiber. |
| WWAN_PROVIDER_STATE_FORBIDDEN | Der Netzwerkanbieter befindet sich in 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 wird 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 verwandten 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 MIT NULL beendete Zeichenfolge, die den Namen des Netzwerkanbieters darstellt. Dieses Element ist höchstens auf WWAN_PROVIDERNAME_LEN Zeichen beschränkt.
Bei GSM-basierten Netzwerken sollte der Miniporttreiber den Netzwerknamen kürzen, wenn die bevorzugte Darstellung der Länderinitialen und des Mobilfunknetzwerknamens (PPCI&N) länger als WWAN_PROVIDERNAME_LEN Zeichen ist.
Dieses Element wird ignoriert, wenn der MB-Dienst die bevorzugte Anbieterliste festlegt.
Miniport-Treiber sollten eine NULL- Zeichenfolge für Geräte angeben, die diese Informationen nicht enthalten.
WwanDataClass
Eine Bitmap, die die vom Gerät unterstützte Datenklasse(n) darstellt. Eine detaillierte Liste der Werte finden Sie im WwanDataClass Member von WWAN_DEVICE_CAPS.
Dieses Element kann ignoriert werden, wenn sie nach OID_WWAN_HOME_PROVIDER abgefragt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen von Windows. |
| Header- | wwan.h (include Wwan.h) |