RILADDRESS 结构 （ntddrilapitypes.h）

警告 Windows 10 中弃用手机网络 COM API。 提供此内容以支持维护 OEM 和移动运营商创建的 Windows Phone 8.1 应用程序。

 

此结构表示电话号码。

语法

struct RILADDRESS {
  DWORD cbSize;
  DWORD dwParams;
  DWORD dwType;
  DWORD dwNumPlan;
  WCHAR wszAddress[MAXLENGTH_ADDRESS];
};

成员

cbSize

结构的大小（以字节为单位）。

dwParams

RILADDRESSPARAMMASK 枚举值的按位组合，指示结构的哪些成员包含有效数据。 如果设置了相应的位标志，则结构的成员有效。

dwType

地址的类型。 下表显示了可能的值。

价值	意义
RIL_ADDRTYPE_UNKNOWN	未知类型
RIL_ADDRTYPE_INTERNATIONAL	国际号码
RIL_ADDRTYPE_NATIONAL	国家/地区编号
RIL_ADDRTYPE_NETWKSPECIFIC	特定于网络的数字
RIL_ADDRTYPE_SUBSCRIBER	订阅服务器编号（特定于协议）
RIL_ADDRTYPE_ALPHANUM	字母数字地址
RIL_ADDRTYPE_ABBREV	缩写数字
RIL_ADDRTYPE_IP	IP地址
RIL_ADDRTYPE_EMAIL	Internet 电子邮件地址（RFC 822）

dwNumPlan

地址的编号方案。 下表显示了可能的值。

价值	意义
RIL_NUMPLAN_UNKNOWN	未知编号计划
RIL_NUMPLAN_TELEPHONE	ISDN/电话号码计划（E.164/E.163）
RIL_NUMPLAN_DATA	数据编号计划 （X.121）
RIL_NUMPLAN_TELEX	Telex 编号计划
RIL_NUMPLAN_NATIONAL	国家/地区编号计划
RIL_NUMPLAN_PRIVATE	专用编号计划
RIL_NUMPLAN_ERMES	ERMES 编号计划 （ETSI DE/PS 3 01-3）

wszAddress[256]

地址字符数组。 此数组的最小长度为 3。 当 dwType 设置为 RIL_ADDRTYPE_INTERNATIONAL时，加号 （+） 不会作为前缀 wszAddress。 由客户端或调制解调器来附加符号。

言论

当 RILADDRESS 表示 UICC 卡上的电话号码时，wszAddress 的内容将限制为卡上可以表示的值（由 3GPP TS 31.102 表 4.4 定义）。 在 UICC 文件中，电话号码由用 0xF 填充在右侧的 4 位小号字符串表示。 下表显示了定义的映射。

UICC EF 中的 nibble	wszAddress 中的 WCHAR	意义
0x0	L'0'	数字 0
0x1	L'1'	数字 1
0x2	L'2'	数字 2
0x3	L'3'	数字 3
0x4	L'4'	数字 4
0x5	L'5'	数字 5
0x6	L'6'	数字 6
0x7	L'7'	数字 7
0x8	L'8'	数字 8
0x9	L'9'	数字 9
0xA	L'*'	星号字符
0xB	L'#'	井号字符
0xC	L'p' 或 L'P'	DTMF 控制数字分隔符（请参阅 3GPP TS 22.101）
0xD	L'?'	“Wild”值（请参阅 3GPP TS 22.101）
0xE		RFU - 不使用
0xF		UICC 卡上未使用的填充 - 不使用

 

在控制数字分隔符的情况下，可以传入大写或小写“P”;输出始终小写。 0xE的 RFU 值不应出现在卡片上，但如果它被报告为 L'e'。 将 L'e' 作为输入传递是错误的。

要求

要求	价值
标头	ntddrilapitypes.h （include Rilapitypes.h， Ntddrilapitypes.h）

另请参阅

手机网络 COM 结构