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 | |
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]
表示网络提供程序名称的 NULL 终止字符串。 此成员最多只能WWAN_PROVIDERNAME_LEN个字符。
对于基于 GSM 的网络,如果首选国家/地区首字母缩写和移动网络名称(PPCI&N)长于WWAN_PROVIDERNAME_LEN个字符,则微型端口驱动程序应缩写网络名称。
当 MB 服务设置首选提供程序列表时,将忽略此成员。
微型端口驱动程序应为没有此信息的设备指定 NULL 字符串。
WwanDataClass
表示设备支持的数据类(es)的位图。 有关值的详细列表,请参阅 WWAN_DEVICE_CAPS的 WwanDataClass 成员。
查询OID_WWAN_HOME_PROVIDER时,可以忽略此成员。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows 7 及更高版本的 Windows 中可用。 |
标头 | wwan.h (包括 Wwan.h) |