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