fonction lineTranslateDialog (tapi.h)

Article
08/26/2023

La fonction lineTranslateDialog affiche une boîte de dialogue modale d’application qui permet à l’utilisateur de modifier l’emplacement actuel d’un numéro de téléphone sur le point d’être composé, d’ajuster l’emplacement et d’appeler carte paramètres et de voir l’effet.

Syntaxe

LONG lineTranslateDialog(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  HWND     hwndOwner,
  LPCSTR   lpszAddressIn
);

Paramètres

hLineApp

Handle d’application retourné par lineInitializeEx. Si une application n’a pas encore appelé la fonction lineInitializeEx , elle peut définir le paramètre hLineApp sur zéro.

dwDeviceID

Identificateur de l’appareil de ligne sur lequel l’appel est destiné à être composé, afin 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 le périphérique de ligne indiqué par dwDeviceID).

hwndOwner

Handle à une fenêtre à laquelle la boîte de dialogue doit être attachée. Peut être une valeur NULL pour indiquer que toute fenêtre créée pendant la fonction ne doit avoir aucune fenêtre propriétaire.

lpszAddressIn

Pointeur vers une chaîne terminée par un caractère Null contenant un numéro de téléphone utilisé, dans la partie inférieure de la boîte de dialogue, pour afficher l’effet des modifications de l’utilisateur sur les paramètres d’emplacement. Le nombre doit être au format canonique ; si elle n’est pas automatique, la partie numéro de téléphone de la boîte de dialogue n’est pas affichée. Ce pointeur peut être null gauche, auquel cas la partie numéro de téléphone de la boîte de dialogue n’est pas affichée. Si le paramètre lpszAddressIn contient un champ sous-adresse ou 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 utilisée dans la boîte de dialogue.

Valeur retournée

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

LINEERR_BADDEVICEID, LINEERR_INVALPARAM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INVALPOINTER, LINEERR_INIFILECORRUPT, LINEERR_NODRIVER, LINEERR_INUSE, LINEERR_NOMEM, LINEERR_INVALADDRESS, LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED.

Remarques

Dans TAPI version 2.0 ou ultérieure, plusieurs instances de cette boîte de dialogue peuvent être ouvertes. Dans les versions TAPI antérieures à 2.0, LINEERR_INUSE est retourné si la boîte de dialogue est déjà affichée par une autre application (elle ne peut pas être ouverte plusieurs fois). Dans ces versions, TAPI place la boîte de dialogue existante au premier plan, et l’erreur indique que les détails liés à l’adresse passée par l’application actuelle n’ont pas été gérés, car cette adresse n’a pas été traitée par la fonction .

L’application doit appeler lineGetTranslateCaps après cette fonction pour obtenir les modifications apportées par l’utilisateur aux paramètres de traduction d’adresses téléphoniques, et appeler lineTranslateAddress pour obtenir une chaîne accessible en fonction des nouvelles sélections de l’utilisateur.

Si une fonction liée à la traduction d’adresses (par exemple, lineGetTranslateCaps ou lineTranslateAddress) retourne LINEERR_INIFILECORRUPT, l’application doit appeler lineTranslateDialog. La fonction lineTranslateDialog détecte les erreurs et les corrige, puis signale l’action effectuée à l’utilisateur.