Compartilhar via


Estrutura RILADDRESS (ntddrilapitypes.h)

Aviso A API COM da rede celular foi preterida em Windows 10. Esse conteúdo é fornecido para dar suporte à manutenção do OEM e da operadora móvel criada Windows Phone aplicativos 8.1.
 
Essa estrutura representa um número de telefone.

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)

Confira também

Estruturas COM da rede celular