STRUCTURE LINECARDENTRY (tapi.h)
La structure LINECARDENTRY décrit un carte appelant. La structure LINETRANSLATECAPS peut contenir un tableau de structures LINECARDENTRY .
Syntaxe
typedef struct linecardentry_tag {
DWORD dwPermanentCardID;
DWORD dwCardNameSize;
DWORD dwCardNameOffset;
DWORD dwCardNumberDigits;
DWORD dwSameAreaRuleSize;
DWORD dwSameAreaRuleOffset;
DWORD dwLongDistanceRuleSize;
DWORD dwLongDistanceRuleOffset;
DWORD dwInternationalRuleSize;
DWORD dwInternationalRuleOffset;
DWORD dwOptions;
} LINECARDENTRY, *LPLINECARDENTRY;
Membres
dwPermanentCardID
Identificateur permanent qui identifie le carte.
dwCardNameSize
Taille de la chaîne de nom carte, y compris la fin null, en octets.
dwCardNameOffset
Décaler du début de la structure vers une chaîne terminée par null qui décrit le carte de manière conviviale. La taille du champ est spécifiée par dwCardNameSize.
dwCardNumberDigits
Nombre de chiffres dans le nombre de carte existant. Le numéro de carte lui-même n’est pas retourné pour des raisons de sécurité (il est stocké sous forme brouillée par TAPI). L’application peut l’utiliser pour insérer des octets de remplissage dans un contrôle de texte en mode « mot de passe » afin de montrer qu’un nombre existe.
dwSameAreaRuleSize
Taille de la règle de numérotation de même zone, y compris la fin null , en octets.
dwSameAreaRuleOffset
Décalage entre le début de la structure LINETRANSLATECAPS et la règle de numérotation définie pour les appels aux numéros dans le même indicatif régional. La règle est une chaîne terminée par null. La taille du champ est spécifiée par dwSameAreaRuleSize.
dwLongDistanceRuleSize
Taille de la règle de numérotation longue distance, y compris la fin null , en octets.
dwLongDistanceRuleOffset
Décalage entre le début de la structure et la règle de numérotation définie pour les appels aux numéros dans les autres zones du même pays/région. La règle est une chaîne terminée par null. La taille du champ est spécifiée par dwLongDistanceRuleSize.
dwInternationalRuleSize
Taille de la règle de numérotation internationale, y compris la fin null , en octets.
dwInternationalRuleOffset
Décalage entre le début de la structure et la règle de numérotation définie pour les appels à des numéros dans d’autres pays/régions. La règle est une chaîne terminée par null. La taille du champ est spécifiée par dwInternationalRuleSize.
dwOptions
Indique d’autres paramètres associés à cette carte d’appel, à l’aide des constantes LINECARDOPTION_.
Remarques
Les applications plus anciennes sont compilées sans connaissance de ces nouveaux champs et à l’aide d’un FORMAT SIZEOF(LINECARDENTRY) plus petit que la nouvelle taille. Étant donné qu’il s’agit d’un tableau dans la partie variable d’une structure LINETRANSLATECAPS , il est impératif que les applications plus anciennes reçoivent des structures LINECARDENTRY dans le format qu’elles attendaient auparavant, ou qu’elles ne sont pas en mesure d’indexer correctement via le tableau. L’application transmet un paramètre dwAPIVersion avec la fonction lineGetTranslateCaps , qui peut être utilisée à des fins d’aide par TAPI dans la gestion de cette situation. La fonction lineGetTranslateCaps doit utiliser les champs LINECARDENTRY et la taille correspondant à la version d’API indiquée lors de la génération de la structure LINETRANSLATECAPS à retourner à l’application.
Cette structure peut ne pas être étendue.
Configuration requise
Condition requise | Valeur |
---|---|
En-tête | tapi.h |