STRUCTURE LINELOCATIONENTRY (tapi.h)
La structure LINELOCATIONENTRY décrit un emplacement utilisé pour fournir un contexte de traduction d’adresse. La structure LINETRANSLATECAPS peut contenir un tableau de structures LINELOCATIONENTRY .
Syntaxe
typedef struct linelocationentry_tag {
DWORD dwPermanentLocationID;
DWORD dwLocationNameSize;
DWORD dwLocationNameOffset;
DWORD dwCountryCode;
DWORD dwCityCodeSize;
DWORD dwCityCodeOffset;
DWORD dwPreferredCardID;
DWORD dwLocalAccessCodeSize;
DWORD dwLocalAccessCodeOffset;
DWORD dwLongDistanceAccessCodeSize;
DWORD dwLongDistanceAccessCodeOffset;
DWORD dwTollPrefixListSize;
DWORD dwTollPrefixListOffset;
DWORD dwCountryID;
DWORD dwOptions;
DWORD dwCancelCallWaitingSize;
DWORD dwCancelCallWaitingOffset;
} LINELOCATIONENTRY, *LPLINELOCATIONENTRY;
Membres
dwPermanentLocationID
Permanent. Identifie l’emplacement.
dwLocationNameSize
Taille, en caractères, d’une chaîne de nom d’emplacement null, y compris le caractère de fin null.
dwLocationNameOffset
Taille de décalage, spécifiée dans dwLocationNameSize, du début de la structure LINETRANSLATECAPS (qui contient cette entrée) à une chaîne terminée par null qui décrit l’emplacement de manière conviviale.
dwCountryCode
Code de pays ou de région de l’emplacement.
dwCityCodeSize
Taille, en caractères, de la chaîne de code de ville terminée par null, y compris le caractère de fin null.
dwCityCodeOffset
Décalage, spécifié dans dwCityCodeSize, du début de cette structure à une chaîne terminée par null spécifiant le code de ville/zone associé à l’emplacement. Ces informations, avec l’indicatif de pays ou de région, peuvent être utilisées par les applications pour les champs d’entrée « par défaut » pour l’utilisateur lors de la saisie de numéros de téléphone, afin d’encourager la saisie de numéros canoniques appropriés.
dwPreferredCardID
Les carte d’appel préférés lors de la numérotation à partir de cet emplacement.
dwLocalAccessCodeSize
Taille, en octets, de la chaîne de code d’accès locale, y compris la fin null .
dwLocalAccessCodeOffset
Taille de décalage, spécifiée dans dwLocalAccessCodeSize, du début de la structure LINETRANSLATECAPS à une chaîne null contenant le code d’accès à composer avant les appels aux adresses dans la zone d’appel locale.
dwLongDistanceAccessCodeSize
Taille, en octets, du code d’accès à longue distance, y compris la terminaison null .
dwLongDistanceAccessCodeOffset
Taille de décalage, spécifiée dans dwLongDistanceAccessCodeSize, du début de la structure LINETRANSLATECAPS à une chaîne terminée par null contenant le code d’accès à composer avant les appels à des adresses en dehors de la zone d’appel locale.
dwTollPrefixListSize
Taille, en octets, du préfixe de péage, y compris la terminaison null .
dwTollPrefixListOffset
Taille de décalage, spécifiée dans dwTollPrefixListSize, du début de la structure LINETRANSLATECAPS à une chaîne null contenant la liste de préfixes de péage pour l’emplacement. La chaîne contient uniquement des préfixes constitués des chiffres « 0 » à « 9 », séparés les uns des autres par un seul caractère « , » (virgule).
dwCountryID
Identificateur du pays/région sélectionné pour l’emplacement. Cela peut être utilisé avec la fonction lineGetCountry pour obtenir des informations supplémentaires sur le pays/la région spécifique, comme le nom du pays/de la région (le membre dwCountryCode ne peut pas être utilisé à cette fin, car les codes pays/région ne sont pas uniques).
dwOptions
Options en vigueur pour cet emplacement, avec des valeurs extraites des constantes LINELOCATIONOPTION_.
dwCancelCallWaitingSize
Taille, en octets, de la chaîne cancel-call-waiting.
dwCancelCallWaitingOffset
Taille de décalage, spécifiée dans dwCancelCall WaitingSize, du début de la structure LINETRANSLATECAPS à une chaîne terminée par null contenant les chiffres de numérotation et les caractères modificateurs qui doivent être préfixés à la chaîne accessible (après le caractère pulsé/tonalité) lorsqu’une application définit le bit LINETRANSLATEOPTION_CANCELCALLWAITING dans le paramètre dwTranslateOptions de lineTranslateAddress. Si aucun préfixe n’est défini, dwCancelCall WaitingSize peut avoir la valeur zéro, ou 1, et dwCancelCall WaitingOffset peut pointer vers une chaîne vide (octet NULL unique).
Remarques
Cette structure ne peut pas être étendue.
Les applications plus anciennes sont compilées sans connaître ces nouveaux champs et à l’aide d’une taille SIZEOF LINELOCATIONENTRY plus petite 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 LINELOCATIONENTRY au format qu’elles attendaient auparavant, ou qu’elles ne soient 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 membres LINELOCATIONENTRY et la taille correspondant à la version d’API indiquée, lors de la génération de la structure LINETRANSLATECAPS à retourner à l’application.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | tapi.h |