fonction lineTranslateAddress (tapi.h)

Article
08/26/2023

La fonction lineTranslateAddress traduit l’adresse spécifiée dans un autre format.

Syntaxe

LONG lineTranslateAddress(
  HLINEAPP              hLineApp,
  DWORD                 dwDeviceID,
  DWORD                 dwAPIVersion,
  LPCSTR                lpszAddressIn,
  DWORD                 dwCard,
  DWORD                 dwTranslateOptions,
  LPLINETRANSLATEOUTPUT lpTranslateOutput
);

Paramètres

hLineApp

Handle retourné par lineInitializeEx. Si une application TAPI 2.x n’a pas encore appelé la fonction lineInitializeEx , elle peut définir ce paramètre sur NULL. Les applications TAPI 1.4 doivent toujours appeler lineInitialize en premier.

dwDeviceID

Identificateur d’appareil de l’appareil de ligne sur lequel l’appel doit être composé, de sorte que les variations des procédures de numérotation sur différentes lignes puissent être appliquées au processus de traduction.

dwAPIVersion

Version la plus élevée de TAPI prise en charge par l’application (pas nécessairement la valeur négociée par lineNegotiateAPIVersion sur un appareil de ligne particulier).

lpszAddressIn

Pointeur vers une chaîne terminée par null qui contient l’adresse des informations à extraire pour la traduction. Doit être au format d’adresse canonique ou dans une chaîne arbitraire de chiffres numérotationables (non canoniques). Ce paramètre ne doit pas avoir la valeur NULL. Si AddressIn contient un champ de sous-adresse ou de nom, ou des adresses supplémentaires séparées de la première adresse par des caractères CR et LF, seule la première adresse est traduite.

dwCard

Les carte de crédit à utiliser pour la numérotation. Ce paramètre n’est valide que si le bit CARDOVERRIDE est défini dans dwTranslateOptions. Ce paramètre spécifie l’identificateur permanent d’une entrée card dans la section [Cartes] du Registre (obtenue à partir de lineTranslateCaps) qui doit être utilisé au lieu du PreferredCardID spécifié dans la définition de CurrentLocation. Cela n’entraîne pas la modification du paramètre PreferredCardID de l’entrée Emplacement actuelle dans le Registre ; le remplacement s’applique uniquement à l’opération de traduction en cours. Ce paramètre est ignoré si le bit CARDOVERRIDE n’est pas défini dans dwTranslateOptions.

dwTranslateOptions

Opérations associées à effectuer avant la traduction de l’adresse en chaîne numérotationable. Ce paramètre utilise l’une des constantes LINETRANSLATEOPTION_.

Si vous avez défini le bit LINETRANSLATEOPTION_CANCELCALLWAITING, il est également conseillé de définir le bit LINECALLPARAMFLAGS_SECURE dans le membre dwCallParamFlags de la structure LINECALLPARAMS (passé à lineMakeCallcall via le paramètre lpCallParams ). Cela empêche l’appareil de ligne d’utiliser des chiffres pouvant être composés pour supprimer les interruptions d’appel.

lpTranslateOutput

Pointeur vers une zone de mémoire allouée par l’application pour contenir la sortie de l’opération de traduction, de type LINETRANSLATEOUTPUT. Avant d’appeler lineTranslateAddress, l’application doit définir le membre dwTotalSize de cette structure pour indiquer la quantité de mémoire disponible pour TAPI pour retourner des informations.

Valeur retournée

Retourne zéro si la requête réussit ou un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_BADDEVICEID, LINEERR_INVALPOINTER, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NODRIVER, LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCARD, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPARAM.