STRUCTURE LINETRANSLATEOUTPUT (tapi.h)

Article
01/10/2024

La structure LINETRANSLATEOUTPUT décrit le résultat d’une traduction d’adresse. La fonction lineTranslateAddress utilise cette structure.

Syntaxe

typedef struct linetranslateoutput_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwDialableStringSize;
  DWORD dwDialableStringOffset;
  DWORD dwDisplayableStringSize;
  DWORD dwDisplayableStringOffset;
  DWORD dwCurrentCountry;
  DWORD dwDestCountry;
  DWORD dwTranslateResults;
} LINETRANSLATEOUTPUT, *LPLINETRANSLATEOUTPUT;

Membres

dwTotalSize

Taille totale allouée à cette structure de données, en octets.

dwNeededSize

Taille nécessaire pour que cette structure de données contienne toutes les informations retournées, en octets.

dwUsedSize

Taille de la partie de cette structure de données qui contient des informations utiles, en octets.

dwDialableStringSize

Taille de la chaîne numérotationable, en octets, y compris la valeur NULL de fin.

dwDialableStringOffset

Décalage du début de cette structure vers la sortie traduite qui peut être passée à la fonction lineMakeCall, lineDial ou autre nécessitant une chaîne numérotationable. La sortie est toujours une chaîne terminée par null. Les champs auxiliaires tels que nom et sous-adresse sont inclus dans cette chaîne de sortie s’ils se trouvent dans la chaîne d’entrée. Cette chaîne peut contenir des informations privées telles que l’appel de numéros carte. Il ne doit pas être affiché à l’utilisateur, afin d’empêcher une visibilité par inadvertance pour des personnes non autorisées. La taille du champ est spécifiée par dwDialableStringSize.

dwDisplayableStringSize

Taille de la sortie traduite qui peut être affichée à l’utilisateur, y compris la fin null , en octets.

dwDisplayableStringOffset

Décalage vers la sortie traduite qui peut être affichée à l’utilisateur pour confirmation. Il est identique à DialableString, à l’exception de l’appel carte chiffres sont remplacés par le nom convivial du carte placé entre crochets (par exemple, « [AT&T Card] ») et les champs auxiliaires tels que nom et sous-adresse sont supprimés. Utilisez un message approprié dans dwDisplayableStringOffset, car la chaîne peut être affichée publiquement dans la boîte de dialogue status d’appel. Ces informations sont également appropriées à inclure dans les journaux des appels. La taille du champ est spécifiée par dwDisplayableStringSize.

dwCurrentCountry

Code de pays ou de région configuré dans CurrentLocation. Cette valeur peut être utilisée pour contrôler l’affichage par l’application de certains éléments de l’interface utilisateur, pour la détection de la tonalité de progression des appels locaux et à d’autres fins.

dwDestCountry

Code pays/région de destination de l’adresse traduite. Cette valeur peut être transmise au paramètre dwCountryCode de lineMakeCall et à d’autres fonctions de numérotation (afin que les tonalités de progression des appels du pays/région de destination, comme un signal occupé, soient correctement détectées). Ce champ est défini sur zéro si l’adresse de destination passée à lineTranslateAddress n’est pas au format canonique.

dwTranslateResults

Informations dérivées du processus de traduction, qui peuvent aider l’application à présenter des éléments d’interface utilisateur. Ce champ utilise l’une des constantes LINETRANSLATERESULT_.