STRUCTURE LINELOCATIONENTRY (tapi.h)

Article
08/26/2023

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.