RILADDRESS - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// ntddrilapitypes.h
struct RILADDRESS {
DWORD cbSize;
DWORD dwParams;
DWORD dwType;
DWORD dwNumPlan;
WCHAR wszAddress[MAXLENGTH_ADDRESS];
};
View the official Windows Driver Kit DDI reference// rilapitypes.h
typedef struct _RILADDRESS {
DWORD cbSize;
DWORD dwParams;
RILADDRESSTYPE dwType;
RILADDRESSNUMPLAN dwNumPlan;
WCHAR [MAXLENGTH_ADDRESS] wszAddress;
} RILADDRESS, RILADDRESS;
View the official Windows Driver Kit DDI referenceNo description available.
Warning The Cellular COM API is deprecated in Windows 10. This content is provided to support maintenance of OEM and mobile operator created Windows Phone 8.1 applications.
This structure represents a phone number.
cbSizeThe size of the structure in bytes.
dwParamsA 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.
dwTypeThe 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) |
dwNumPlanThe 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) |
wszAddressAn 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.
struct RILADDRESS {
DWORD cbSize;
DWORD dwParams;
DWORD dwType;
DWORD dwNumPlan;
WCHAR wszAddress[MAXLENGTH_ADDRESS];
};
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.
This topic supports the Windows driver infrastructure and is not intended to be used directly from your code.
cbSizedwParamsdwTypedwNumPlanwszAddresstypedef struct _RILADDRESS {
DWORD cbSize;
DWORD dwParams;
RILADDRESSTYPE dwType;
RILADDRESSNUMPLAN dwNumPlan;
WCHAR [MAXLENGTH_ADDRESS] wszAddress;
} RILADDRESS, RILADDRESS;