Estructura RILADDRESS (ntddrilapitypes.h)
Sintaxis
struct RILADDRESS {
DWORD cbSize;
DWORD dwParams;
DWORD dwType;
DWORD dwNumPlan;
WCHAR wszAddress[MAXLENGTH_ADDRESS];
};
Miembros
cbSize
Tamaño de la estructura en bytes.
dwParams
Combinación bit a bit de RILADDRESSPARAMMASK valores de enumeración que indican 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. Los valores posibles se muestran en la tabla siguiente.
| Valor | Significado |
|---|---|
| RIL_ADDRTYPE_UNKNOWN | Tipo desconocido |
| 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. Los valores posibles se muestran en la tabla siguiente.
| Valor | Significado |
|---|---|
| RIL_NUMPLAN_UNKNOWN | Plan de numeración desconocido |
| RIL_NUMPLAN_TELEPHONE | Plan de numeración de teléfono/ISDN (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 privado |
| 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.
Observaciones
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 (tal como se define en la tabla 3GPP TS 31.102 4.4). En el archivo UICC, un número de teléfono se representa mediante una cadena de 4 bits acolchados 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" (consulte 3GPP TS 22.101) |
| 0xE | RFU: no se va a usar | |
| 0xF | Relleno para los nibbles no usados en la tarjeta UICC, no se va a 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'. Se trata de un error para pasar L'e' como entrada.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | ntddrilapitypes.h (include Rilapitypes.h, Ntddrilapitypes.h) |