Struttura RILADDRESS (ntddrilapitypes.h)
Sintassi
struct RILADDRESS {
DWORD cbSize;
DWORD dwParams;
DWORD dwType;
DWORD dwNumPlan;
WCHAR wszAddress[MAXLENGTH_ADDRESS];
};
Members
cbSize
Dimensioni della struttura in byte.
dwParams
Combinazione bit per bit dei valori di enumerazione RILADDRESSPARAMMASK che indica quali membri della struttura contengono dati validi. Un membro della struttura è valido se il flag di bit corrispondente è impostato.
dwType
Tipo di indirizzo. Nella tabella seguente vengono illustrati i valori possibili.
| Valore | Significato |
|---|---|
| RIL_ADDRTYPE_UNKNOWN | Tipo unknown |
| RIL_ADDRTYPE_INTERNATIONAL | Numero internazionale |
| RIL_ADDRTYPE_NATIONAL | Numero nazionale/regionale |
| RIL_ADDRTYPE_NETWKSPECIFIC | Numero specifico della rete |
| RIL_ADDRTYPE_SUBSCRIBER | Numero sottoscrittore (specifico del protocollo) |
| RIL_ADDRTYPE_ALPHANUM | Indirizzo alfanumerico |
| RIL_ADDRTYPE_ABBREV | Numero abbreviato |
| RIL_ADDRTYPE_IP | Indirizzo IP |
| RIL_ADDRTYPE_EMAIL | Indirizzo di posta elettronica Internet (RFC 822) |
dwNumPlan
Schema di numerazione dell'indirizzo. Nella tabella seguente vengono illustrati i valori possibili.
| Valore | Significato |
|---|---|
| RIL_NUMPLAN_UNKNOWN | Piano di numerazione sconosciuto |
| RIL_NUMPLAN_TELEPHONE | Piano di numerazione ISDN/telefono (E.164/E.163) |
| RIL_NUMPLAN_DATA | Piano di numerazione dei dati (X.121) |
| RIL_NUMPLAN_TELEX | Piano di numerazione telex |
| RIL_NUMPLAN_NATIONAL | Piano di numerazione nazionale/regionale |
| RIL_NUMPLAN_PRIVATE | Piano di numerazione privato |
| RIL_NUMPLAN_ERMES | Piano di numerazione ERMES (ETSI DE/PS 3 01-3) |
wszAddress[256]
Matrice di caratteri di indirizzo. La lunghezza minima di questa matrice è 3. Quando dwType è impostato su RIL_ADDRTYPE_INTERNATIONAL, il segno più (+) non è preceduto da wszAddress. È fino al client o al modem per collegare il simbolo.
Commenti
Quando un RILADDRESS rappresenta un numero di telefono in una scheda UICC, il contenuto di wszAddress è vincolato ai valori che possono essere rappresentati nella scheda (come definito dalla tabella 3GPP TS 31.102 tabella 4.4). Nel file UICC un numero di telefono è rappresentato da una stringa di nibbles a 4 bit riempita a destra con 0xF. Il mapping definito è illustrato nella tabella seguente.
| nibble in UICC EF | WCHAR in wszAddress | Significato |
|---|---|---|
| 0x0 | L'0' | Cifra 0 |
| 0x1 | L'1' | Cifra 1 |
| 0x2 | L'2' | Cifra 2 |
| 0x3 | L'3' | Cifra 3 |
| 0x4 | L'4' | Cifra 4 |
| 0x5 | L'5' | Cifra 5 |
| 0x6 | L'6' | Cifra 6 |
| 0x7 | L'7' | Cifra 7 |
| 0x8 | L'8' | Cifra 8 |
| 0x9 | L'9' | Cifra 9 |
| 0xA | L'*' | Carattere asterisco |
| 0xB | L'#' | Carattere Sterlina |
| 0xC | L'p' o L'P' | Separatore delle cifre di controllo DTMF (vedere 3GPP TS 22.101) |
| 0xD | L'?' | Valore "Wild" (vedere 3GPP TS 22.101) |
| 0xE | RFU: non da usare | |
| 0xF | Spaziatura interna per i nibbles inutilizzati nella scheda UICC, non da usare |
Nel caso del separatore delle cifre di controllo, è possibile passare 'P' maiuscolo o minuscolo; l'output è sempre minuscolo. Il valore RFU 0xE non dovrebbe mai essere visualizzato nella scheda, ma se lo fa viene segnalato come L'e'. Si tratta di un errore per passare L'e' come input.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | ntddrilapitypes.h (include Rilapitypes.h, Ntddrilapitypes.h) |