WWAN_PROVIDER structure (wwan.h)
The WWAN_PROVIDER structure represents details about a network provider.
Syntax
typedef struct _WWAN_PROVIDER {
WCHAR ProviderId[WWAN_PROVIDERID_LEN];
ULONG ProviderState;
WCHAR ProviderName[WWAN_PROVIDERNAME_LEN];
ULONG WwanDataClass;
} WWAN_PROVIDER, *PWWAN_PROVIDER;
Members
ProviderId[WWAN_PROVIDERID_LEN]
A NULL-terminated numeric (0-9) string that represents the network provider identity.
For GSM-based networks, this string is a concatenation of a three-digit Mobile Country Code (MCC) and a two or three-digit Mobile Network Code (MNC). GSM-based carriers may have more than one MNC, and hence more than one ProviderId .
For CDMA-based networks, this string is a five-digit System ID (SID). Generally a CDMA-based carrier has more than one SID. Typically, the carrier has one SID for each market, which is usually divided geographically within a nation by regulations, such as Metropolitan Statistical Areas (MSA) in the United States of America. Miniport drivers of CDMA-based devices must specify WWAN_CDMA_DEFAULT_PROVIDER_ID if this information is not available.
ProviderState
A value that represents the various states that the network provider's entry can be tagged with. The following table shows the possible values that miniport drivers should specify (one or more values can be specified).
| Value | Meaning |
|---|---|
| WWAN_PROVIDER_STATE_HOME | The network provider is the home operator. |
| WWAN_PROVIDER_STATE_FORBIDDEN | The network provider is on the forbidden list. |
| WWAN_PROVIDER_STATE_PREFERRED | The network provider is on the preferred list. |
| WWAN_PROVIDER_STATE_VISIBLE | The network provider is visible. |
| WWAN_PROVIDER_STATE_REGISTERED | The network provider is currently registered by the device. |
| WWAN_PROVIDER_STATE_UNKNOWN | The network provider state is unknown. |
Some values in the previous table apply only to specific object identifiers (OIDs). The following table shows the associations between those values and related OIDs.
| Value | 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]
A NULL-terminated string that represents the network provider's name. This member is limited to, at most, WWAN_PROVIDERNAME_LEN characters.
For GSM-based networks, if the Preferred Presentation of Country Initials and Mobile Network Name (PPCI&N) is longer than WWAN_PROVIDERNAME_LEN characters, the miniport driver should abbreviate the network name.
This member is ignored when the MB Service sets the preferred provider list.
Miniport drivers should specify a NULL string for devices that do not have this information.
WwanDataClass
A bitmap that represents the data-class(es) that the device supports. For a detailed list of values, see the WwanDataClass member of WWAN_DEVICE_CAPS.
This member can be ignored when queried for OID_WWAN_HOME_PROVIDER.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows 7 and later versions of Windows. |
| Header | wwan.h (include Wwan.h) |