Structure RILADDRESS (ntddrilapitypes.h)

  • Article
Avertissement L’API COM cellulaire est déconseillée dans Windows 10. Ce contenu est fourni pour prendre en charge la maintenance des applications OEM et opérateur mobile créées Windows Phone applications 8.1.
 
Cette structure représente un numéro de téléphone.

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)

Voir aussi

Structures COM cellulaires