Структура RILADDRESS (ntddrilapitypes.h)
Синтаксис
struct RILADDRESS {
DWORD cbSize;
DWORD dwParams;
DWORD dwType;
DWORD dwNumPlan;
WCHAR wszAddress[MAXLENGTH_ADDRESS];
};
Члены
cbSize
Размер структуры в байтах.
dwParams
Побитовое сочетание значений перечисления RILADDRESSPARAMMASK , указывающее, какие элементы структуры содержат допустимые данные. Член структуры является допустимым, если задан соответствующий битовый флаг.
dwType
Тип адреса. Возможные значения перечислены в следующей таблице.
| Значение | Значение |
|---|---|
| RIL_ADDRTYPE_UNKNOWN | Тип 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 ограничивается значениями, которые могут быть представлены на карта (как определено в таблице 4.4 3GPP TS 31.102). В файле 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 | РФС — не будет использоваться | |
| 0xF | Заполнение для неиспользуемых грызков на карта UICC — не используется |
В случае разделителя контрольных цифр можно передать букву "P" в верхнем или нижнем регистре; выходные данные всегда будут в нижнем регистре. Значение RFU, 0xE, никогда не должно отображаться в карта, но если оно есть, оно отображается как L'e'. Передача L'e в качестве входных данных является ошибкой.
Требования
| Требование | Значение |
|---|---|
| Заголовок | ntddrilapitypes.h (включая Rilapitypes.h, Ntddrilapitypes.h) |