Структура RILADDRESS (ntddrilapitypes.h)
Синтаксис
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 | План нумерирования телексов |
| 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). В файле UICC номер телефона представлен строкой 4-разрядных накладок справа с 0xF. Определенное сопоставление показано в следующей таблице.
| nibble в UICC EF | WCHAR в wszAddress | Значение |
|---|---|---|
| 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; Выходные данные всегда являются строчным регистром. Значение RFU, 0xE никогда не должно отображаться на карточке, но если он делает это, сообщается как L'e'. Это ошибка передачи L'e в качестве входных данных.
Требования
| Требование | Ценность |
|---|---|
| заголовка | ntddrilapitypes.h (include Rilapitypes.h, Ntddrilapitypes.h) |