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 de RILADDRESSPARAMMASK valeurs d’énumération qui indiquent les membres de la structure qui 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 indiquées dans le tableau suivant.
| Valeur | Signification |
|---|---|
| RIL_ADDRTYPE_UNKNOWN | Type inconnu |
| 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 indiquées dans le tableau suivant.
| Valeur | Signification |
|---|---|
| RIL_NUMPLAN_UNKNOWN | Plan de numérotation inconnu |
| RIL_NUMPLAN_TELEPHONE | Plan 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éléx |
| RIL_NUMPLAN_NATIONAL | Plan national/régional de numérotation |
| RIL_NUMPLAN_PRIVATE | Plan de numérotation privée |
| 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écédé de wszAddress . Il incombe au client ou au modem d’attacher le symbole.
Remarques
Lorsqu’un RILADDRESS représente un numéro de téléphone sur une carte UICC, le contenu de wszAddress est limité aux valeurs qui peuvent être représentées sur la carte (comme défini par la table 3GPP TS 31.102 4.4). Dans le fichier UICC, un numéro de téléphone est représenté par une chaîne de 4 bits râpées sur la droite avec 0xF. Le mappage défini est illustré dans le tableau suivant.
| nibble 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 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 être utilisé | |
| 0xF | Remplissage pour les pavés inutilisés sur la carte UICC , à ne pas utiliser |
Dans le cas du séparateur de chiffres de contrôle, les majuscules ou minuscules 'P' peuvent être passées ; la sortie est toujours en minuscules. La valeur RFU 0xE ne doit jamais apparaître sur la carte, mais si elle est signalée comme L’e'. Il s’agit d’une erreur pour passer L’e' en tant qu’entrée.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ntddrilapitypes.h (include Rilapitypes.h, Ntddrilapitypes.h) |