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 結構