RILADDRESS 結構 (ntddrilapitypes.h)

警告行動數據 COM API 在 Windows 10 中已被取代。 提供此內容以支援 Windows Phone 8.1 應用程式所建立的 OEM 和電信業者維護。

 

這個結構代表電話號碼。

語法

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	因特網電子郵件位址 (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檔案中，電話號碼是以4位nibbles字串來表示，其右側會以0xF填補。 下表顯示定義的對應。

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 卡片上填補未使用的 Nibbles，而不是使用

 

在控制數位分隔符的情況下，可以傳入大寫或小寫 'P';輸出一律為小寫。 RFU 值0xE永遠不會出現在卡片上，但如果它回報為 L'e'， 傳遞 L'e' 作為輸入時發生錯誤。

規格需求

需求	值
標頭	ntddrilapitypes.h (include Rilapitypes.h、 Ntddrilapitypes.h)

另請參閱

行動數據 COM 結構