WWAN_PROVIDER结构(wwan.h)

WWAN_PROVIDER结构表示有关网络提供程序的详细信息。

语法

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

成员

ProviderId[WWAN_PROVIDERID_LEN]

表示网络提供程序标识的以 NULL 结尾的数字 (0-9) 字符串。

对于基于 GSM 的网络,此字符串是三位数移动国家/地区代码(MCC)和两个或三位数移动网络代码(MNC)的串联。 基于 GSM 的运营商可能有多个 MNC,因此多个 ProviderId

对于基于 CDMA 的网络,此字符串是五位数的系统 ID(SID)。 通常,基于 CDMA 的运营商具有多个 SID。 通常,航空公司为每个市场都有一个 SID,它通常按法规在一个国家之间划分,例如美国大都会统计区(MSA)。 如果此信息不可用,则基于 CDMA 设备的微型端口驱动程序必须指定WWAN_CDMA_DEFAULT_PROVIDER_ID。

ProviderState

一个值,该值表示网络提供程序的条目可以标记的各种状态。 下表显示了微型端口驱动程序应指定的可能值(可以指定一个或多个值)。

价值 意义
WWAN_PROVIDER_STATE_HOME 网络提供商是家庭运营商。
WWAN_PROVIDER_STATE_FORBIDDEN 网络提供程序位于禁止列表中。
WWAN_PROVIDER_STATE_PREFERRED 网络提供程序位于首选列表中。
WWAN_PROVIDER_STATE_VISIBLE 网络提供程序可见。
WWAN_PROVIDER_STATE_REGISTERED 网络提供程序当前由设备注册。
WWAN_PROVIDER_STATE_UNKNOWN 网络提供程序状态未知。
 

上表中的某些值仅适用于特定对象标识符(OID)。 下表显示了这些值与相关 OID 之间的关联。

价值 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]

表示网络提供程序名称的 NULL 终止字符串。 此成员最多只能WWAN_PROVIDERNAME_LEN个字符。

对于基于 GSM 的网络,如果首选国家/地区首字母缩写和移动网络名称(PPCI&N)长于WWAN_PROVIDERNAME_LEN个字符,则微型端口驱动程序应缩写网络名称。

当 MB 服务设置首选提供程序列表时,将忽略此成员。

微型端口驱动程序应为没有此信息的设备指定 NULL 字符串。

WwanDataClass

表示设备支持的数据类(es)的位图。 有关值的详细列表,请参阅 WWAN_DEVICE_CAPSWwanDataClass 成员。

查询OID_WWAN_HOME_PROVIDER时,可以忽略此成员。

要求

要求 价值
最低支持的客户端 在 Windows 7 及更高版本的 Windows 中可用。
标头 wwan.h (包括 Wwan.h)

另请参阅

NDIS_WWAN_HOME_PROVIDER

NDIS_WWAN_PREFERRED_PROVIDERS

NDIS_WWAN_VISIBLE_PROVIDERS

WWAN_DEVICE_CAPS