Structure RILADDRESS (ntddrilapitypes.h)
Syntaxe
struct RILADDRESS {
DWORD cbSize;
DWORD dwParams;
DWORD dwType;
DWORD dwNumPlan;
WCHAR wszAddress[MAXLENGTH_ADDRESS];
};
Membres
cbSize
Taille de la structure en octets.
dwParams
Combinaison au niveau du bit des valeurs d’énumération RILADDRESSPARAMMASK qui indique quels membres de la structure contiennent des données valides. Un membre de la structure est valide si l’indicateur de bits correspondant est défini.
dwType
Type d’adresse. Les valeurs possibles sont présentées dans le tableau suivant.
| Valeur | Signification |
|---|---|
| RIL_ADDRTYPE_UNKNOWN | Type unknown |
| RIL_ADDRTYPE_INTERNATIONAL | Numéro international |
| RIL_ADDRTYPE_NATIONAL | Numéro national/régional |
| RIL_ADDRTYPE_NETWKSPECIFIC | Numéro spécifique au réseau |
| RIL_ADDRTYPE_SUBSCRIBER | Numéro d’abonné (spécifique au protocole) |
| RIL_ADDRTYPE_ALPHANUM | Adresse alphanumérique |
| RIL_ADDRTYPE_ABBREV | Nombre abrégé |
| RIL_ADDRTYPE_IP | Adresse IP |
| RIL_ADDRTYPE_EMAIL | Adresse e-mail Internet (RFC 822) |
dwNumPlan
Schéma de numérotation de l’adresse. Les valeurs possibles sont présentées dans le tableau suivant.
| Valeur | Signification |
|---|---|
| RIL_NUMPLAN_UNKNOWN | Plan de numérotation inconnu |
| RIL_NUMPLAN_TELEPHONE | R ISDN/numéro de téléphone (E.164/E.163) |
| RIL_NUMPLAN_DATA | Plan de numérotation des données (X.121) |
| RIL_NUMPLAN_TELEX | Plan de numérotation de télex |
| RIL_NUMPLAN_NATIONAL | Plan national/régional de numérotation |
| RIL_NUMPLAN_PRIVATE | Plan de numérotation privé |
| RIL_NUMPLAN_ERMES | Plan de numérotation ERMES (ETSI DE/PS 3 01-3) |
wszAddress[256]
Tableau de caractères d’adresse. La longueur minimale de ce tableau est 3. Lorsque dwType est défini sur RIL_ADDRTYPE_INTERNATIONAL, le signe plus (+) n’est pas préfixé à wszAddress. Il appartient au client ou au modem d’attacher le symbole.
Remarques
Lorsqu’une adresse RILADDRESS représente un numéro de téléphone sur un carte UICC, le contenu de wszAddress est limité aux valeurs qui peuvent être représentées sur le carte (telles que définies par 3GPP TS 31.102 tableau 4.4). Dans le fichier UICC, un numéro de téléphone est représenté par une chaîne de grignotines 4 bits rembourrées à droite avec 0xF. Le mappage défini est illustré dans le tableau suivant.
| grignoter dans UICC EF | WCHAR dans wszAddress | Signification |
|---|---|---|
| 0x0 | L'0' | Chiffre 0 |
| 0x1 | L'1' | Chiffre 1 |
| 0x2 | L'2' | Chiffre 2 |
| 0x3 | L'3' | Chiffre 3 |
| 0x4 | L'4' | Chiffre 4 |
| 0x5 | L'5' | Chiffre 5 |
| 0x6 | L'6' | Chiffre 6 |
| 0x7 | L'7' | Chiffre 7 |
| 0x8 | L'8' | Chiffre 8 |
| 0x9 | L'9' | Chiffre 9 |
| 0xA | L'*' | Caractère astérisque |
| 0xB | L'#' | Caractère de livre |
| 0xC | L’p' ou L’P' | Séparateur de chiffres de contrôle DTMF (voir 3GPP TS 22.101) |
| 0xD | L'?' | Valeur « Wild » (voir 3GPP TS 22.101) |
| 0xE | RFU : à ne pas utiliser | |
| 0xF | Rembourrage pour les grignotages inutilisés sur les carte UICC — à ne pas utiliser |
Dans le cas du séparateur de chiffres de contrôle, « P » en majuscules ou minuscules peut être transmis ; la sortie est toujours en minuscules. La valeur RFU 0xE ne doit jamais apparaître sur le carte, mais si c’est le cas, elle est signalée comme L’e'. Il s’agit d’une erreur de passer L’e' comme entrée.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ntddrilapitypes.h (inclure Rilapitypes.h, Ntddrilapitypes.h) |