RILADDRESS structure (ntddrilapitypes.h)
Syntax
struct RILADDRESS {
DWORD cbSize;
DWORD dwParams;
DWORD dwType;
DWORD dwNumPlan;
WCHAR wszAddress[MAXLENGTH_ADDRESS];
};
Members
cbSize
The size of the structure in bytes.
dwParams
A bitwise combination of RILADDRESSPARAMMASK enumeration values that indicates which members of the structure contain valid data. A member of the structure is valid if the corresponding bit flag is set.
dwType
The type of address. Possible values are shown in the following table.
| Value | Meaning |
|---|---|
| RIL_ADDRTYPE_UNKNOWN | Unknown type |
| RIL_ADDRTYPE_INTERNATIONAL | International number |
| RIL_ADDRTYPE_NATIONAL | National/regional number |
| RIL_ADDRTYPE_NETWKSPECIFIC | Network-specific number |
| RIL_ADDRTYPE_SUBSCRIBER | Subscriber number (protocol-specific) |
| RIL_ADDRTYPE_ALPHANUM | Alphanumeric address |
| RIL_ADDRTYPE_ABBREV | Abbreviated number |
| RIL_ADDRTYPE_IP | IP address |
| RIL_ADDRTYPE_EMAIL | Internet email address (RFC 822) |
dwNumPlan
The numbering scheme of the address. Possible values are shown in the following table.
| Value | Meaning |
|---|---|
| RIL_NUMPLAN_UNKNOWN | Unknown numbering plan |
| RIL_NUMPLAN_TELEPHONE | ISDN/telephone numbering plan (E.164/E.163) |
| RIL_NUMPLAN_DATA | Data numbering plan (X.121) |
| RIL_NUMPLAN_TELEX | Telex numbering plan |
| RIL_NUMPLAN_NATIONAL | National/regional numbering plan |
| RIL_NUMPLAN_PRIVATE | Private numbering plan |
| RIL_NUMPLAN_ERMES | ERMES numbering plan (ETSI DE/PS 3 01-3) |
wszAddress[256]
An array of address characters. The minimum length of this array is 3. When dwType is set to RIL_ADDRTYPE_INTERNATIONAL, the plus sign (+) is not prefixed to wszAddress. It is up to the client or modem to attach the symbol.
Remarks
When a RILADDRESS represents a phone number on a UICC card, the contents of wszAddress are constrained to values that can be represented on the card (as defined by 3GPP TS 31.102 table 4.4). In the UICC file, a phone number is represented by a string of 4-bit nibbles padded on the right with 0xF. The defined mapping is shown in the following table.
| nibble in UICC EF | WCHAR in wszAddress | Meaning |
|---|---|---|
| 0x0 | L'0' | Digit 0 |
| 0x1 | L'1' | Digit 1 |
| 0x2 | L'2' | Digit 2 |
| 0x3 | L'3' | Digit 3 |
| 0x4 | L'4' | Digit 4 |
| 0x5 | L'5' | Digit 5 |
| 0x6 | L'6' | Digit 6 |
| 0x7 | L'7' | Digit 7 |
| 0x8 | L'8' | Digit 8 |
| 0x9 | L'9' | Digit 9 |
| 0xA | L'*' | Asterisk character |
| 0xB | L'#' | Pound character |
| 0xC | L'p' or L'P' | DTMF control digits separator (see 3GPP TS 22.101) |
| 0xD | L'?' | "Wild" value (see 3GPP TS 22.101) |
| 0xE | RFU—not to be used | |
| 0xF | Padding for unused nibbles on UICC card—not to be used |
In the case of the control digits separator, either uppercase or lowercase 'P' may be passed in; the output is always lowercase. The RFU value 0xE should never appear on the card, but if it does it is reported as L'e'. It is an error to pass L'e' as input.
Requirements
| Requirement | Value |
|---|---|
| Header | ntddrilapitypes.h (include Rilapitypes.h, Ntddrilapitypes.h) |