Estrutura RILADDRESS (ntddrilapitypes.h)
Sintaxe
struct RILADDRESS {
DWORD cbSize;
DWORD dwParams;
DWORD dwType;
DWORD dwNumPlan;
WCHAR wszAddress[MAXLENGTH_ADDRESS];
};
Membros
cbSize
O tamanho da estrutura em bytes.
dwParams
Uma combinação bit a bit de valores de enumeração RILADDRESSPARAMMASK que indica quais membros da estrutura contêm dados válidos. Um membro da estrutura será válido se o sinalizador de bit correspondente estiver definido.
dwType
O tipo de endereço. Os valores possíveis são mostrados na tabela a seguir.
| Valor | Significado |
|---|---|
| RIL_ADDRTYPE_UNKNOWN | Tipo unknown |
| RIL_ADDRTYPE_INTERNATIONAL | Número internacional |
| RIL_ADDRTYPE_NATIONAL | Número nacional/regional |
| RIL_ADDRTYPE_NETWKSPECIFIC | Número específico da rede |
| RIL_ADDRTYPE_SUBSCRIBER | Número do assinante (específico do protocolo) |
| RIL_ADDRTYPE_ALPHANUM | Endereço alfanumérico |
| RIL_ADDRTYPE_ABBREV | Número abreviado |
| RIL_ADDRTYPE_IP | Endereço IP |
| RIL_ADDRTYPE_EMAIL | Endereço de email da Internet (RFC 822) |
dwNumPlan
O esquema de numeração do endereço. Os valores possíveis são mostrados na tabela a seguir.
| Valor | Significado |
|---|---|
| RIL_NUMPLAN_UNKNOWN | Plano de numeração desconhecido |
| RIL_NUMPLAN_TELEPHONE | ISDN/plano de numeração de telefone (E.164/E.163) |
| RIL_NUMPLAN_DATA | Plano de numeração de dados (X.121) |
| RIL_NUMPLAN_TELEX | Plano de numeração telex |
| RIL_NUMPLAN_NATIONAL | Plano de numeração nacional/regional |
| RIL_NUMPLAN_PRIVATE | Plano de numeração privado |
| RIL_NUMPLAN_ERMES | Plano de numeração ERMES (ETSI DE/PS 3 01-3) |
wszAddress[256]
Uma matriz de caracteres de endereço. O comprimento mínimo dessa matriz é 3. Quando dwType é definido como RIL_ADDRTYPE_INTERNATIONAL, o sinal de adição (+) não é prefixado como wszAddress. Cabe ao cliente ou modem anexar o símbolo.
Comentários
Quando um RILADDRESS representa um número de telefone em um cartão UICC, o conteúdo de wszAddress é restrito a valores que podem ser representados no cartão (conforme definido pela tabela 3GPP TS 31.102 4.4). No arquivo UICC, um número de telefone é representado por uma cadeia de caracteres de mordiscos de 4 bits preenchidas à direita com 0xF. O mapeamento definido é mostrado na tabela a seguir.
| mordiscar no UICC EF | WCHAR em wszAddress | Significado |
|---|---|---|
| 0x0 | L'0' | Dígito 0 |
| 0x1 | L'1' | Dígito 1 |
| 0x2 | L'2' | Dígito 2 |
| 0x3 | L'3' | Dígito 3 |
| 0x4 | L'4' | Dígito 4 |
| 0x5 | L'5' | Dígito 5 |
| 0x6 | L'6' | Dígito 6 |
| 0x7 | L'7' | Dígito 7 |
| 0x8 | L'8' | Dígito 8 |
| 0x9 | L'9' | Dígito 9 |
| 0xA | L'*' | Caractere Asterisco |
| 0xB | L'#' | Caractere de libra |
| 0xC | L'p' ou L'P' | Separador de dígitos de controle DTMF (consulte 3GPP TS 22.101) |
| 0xD | L'?' | Valor "Selvagem" (consulte 3GPP TS 22.101) |
| 0xE | RFU – não deve ser usado | |
| 0xF | Preenchimento para mordiscos não utilizados em cartão UICC — para não ser usado |
No caso do separador de dígitos de controle, o 'P' maiúsculo ou minúsculo pode ser passado para dentro; a saída é sempre minúscula. O valor rfu 0xE nunca deve aparecer no cartão, mas se o fizer, ele será relatado como L'e'. É um erro passar L'e' como entrada.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | ntddrilapitypes.h (inclua Rilapitypes.h, Ntddrilapitypes.h) |