Estructura RILADDRESS (ntddrilapitypes.h)

  • Artículo
Advertencia La API COM de telefonía móvil está en desuso en Windows 10. Este contenido se proporciona para admitir el mantenimiento del oem y el operador de telefonía móvil creados Windows Phone aplicaciones 8.1.
 
Esta estructura representa un número de teléfono.

Sintaxis

struct RILADDRESS {
  DWORD cbSize;
  DWORD dwParams;
  DWORD dwType;
  DWORD dwNumPlan;
  WCHAR wszAddress[MAXLENGTH_ADDRESS];
};

Miembros

cbSize

El tamaño de la estructura en bytes.

dwParams

Combinación bit a bit de valores de enumeración RILADDRESSPARAMMASK que indica qué miembros de la estructura contienen datos válidos. Un miembro de la estructura es válido si se establece la marca de bits correspondiente.

dwType

Tipo de dirección. En la siguiente tabla se muestran los valores posibles.

Valor Significado
RIL_ADDRTYPE_UNKNOWN Tipo unknown
RIL_ADDRTYPE_INTERNATIONAL Número internacional
RIL_ADDRTYPE_NATIONAL Número nacional o regional
RIL_ADDRTYPE_NETWKSPECIFIC Número específico de red
RIL_ADDRTYPE_SUBSCRIBER Número de suscriptor (específico del protocolo)
RIL_ADDRTYPE_ALPHANUM Dirección alfanumérica
RIL_ADDRTYPE_ABBREV Número abreviado
RIL_ADDRTYPE_IP Dirección IP
RIL_ADDRTYPE_EMAIL Dirección de correo electrónico de Internet (RFC 822)

dwNumPlan

Esquema de numeración de la dirección. En la siguiente tabla se muestran los valores posibles.

Valor Significado
RIL_NUMPLAN_UNKNOWN Plan de numeración desconocido
RIL_NUMPLAN_TELEPHONE Plan de numeración de ISDN/teléfono (E.164/E.163)
RIL_NUMPLAN_DATA Plan de numeración de datos (X.121)
RIL_NUMPLAN_TELEX Plan de numeración de Telex
RIL_NUMPLAN_NATIONAL Plan de numeración nacional o regional
RIL_NUMPLAN_PRIVATE Plan de numeración privada
RIL_NUMPLAN_ERMES Plan de numeración ERMES (ETSI DE/PS 3 01-3)

wszAddress[256]

Matriz de caracteres de dirección. La longitud mínima de esta matriz es 3. Cuando dwType se establece en RIL_ADDRTYPE_INTERNATIONAL, el signo más (+) no tiene el prefijo wszAddress. Es hasta el cliente o módem para adjuntar el símbolo.

Comentarios

Cuando un RILADDRESS representa un número de teléfono en una tarjeta UICC, el contenido de wszAddress se restringe a los valores que se pueden representar en la tarjeta (según se define en la tabla 31.102 TS 31.102 4.4). En el archivo UICC, un número de teléfono se representa mediante una cadena de nibbles de 4 bits rellenados a la derecha con 0xF. La asignación definida se muestra en la tabla siguiente.

nibble en UICC EF WCHAR en 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'*' Carácter de asterisco
0xB L'#' Carácter de libra
0xC L'p' o L'P' Separador de dígitos de control DTMF (consulte 3GPP TS 22.101)
0xD L'?' Valor "Salvaje" (véase 3GPP TS 22.101)
0xE RFU: no se va a usar
0xF Relleno para nibbles no usados en la tarjeta UICC, no se debe usar
 

En el caso del separador de dígitos de control, se pueden pasar mayúsculas o minúsculas 'P'; la salida siempre está en minúsculas. El valor de RFU 0xE nunca debería aparecer en la tarjeta, pero si lo hace se notifica como L'e'. Es un error pasar L'e' como entrada.

Requisitos

Requisito Valor
Header ntddrilapitypes.h (include Rilapitypes.h, Ntddrilapitypes.h)

Consulte también

Estructuras COM móviles