Estructura RILADDRESS (ntddrilapitypes.h)
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) |