wwan.h) (WWAN_PROVIDER 结构
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 的网络,此字符串是 SID) (五位数的系统 ID。 通常,基于 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) |