Expand Minimize

WWAN_PROVIDER structure

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

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).

ValueMeaning

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.

ValueOID

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

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

Version

Available in Windows 7 and later versions of Windows.

Header

Wwan.h (include Wwan.h)

See also

NDIS_WWAN_HOME_PROVIDER
NDIS_WWAN_PREFERRED_PROVIDERS
NDIS_WWAN_VISIBLE_PROVIDERS
WWAN_DEVICE_CAPS

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft