ITAddressTranslation ::TranslateDialog, méthode (tapi3if.h)

Article
03/04/2024

La méthode TranslateDialog 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

HRESULT TranslateDialog(
  [in] TAPIHWND hwndOwner,
  [in] BSTR     pAddressIn
);

Paramètres

[in] 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.

[in] pAddressIn

Pointeur vers BSTR contenant un numéro de téléphone utilisé pour afficher l’effet des modifications apportées par l’utilisateur sur les paramètres d’emplacement. Le nombre doit être au format canonique. Ce pointeur peut rester NULL, 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 pAddressIn 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 ASCII CR et LF, seule la première adresse est utilisée dans la boîte de dialogue.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	La méthode a réussi.
E_INVALIDARG	Le paramètre hwndOwner n’est pas un handle valide ou le paramètre pAddressIn n’est pas un numéro de téléphone valide.
E_POINTER	Le paramètre pAddressIn n’est pas un pointeur valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.
E_UNEXPECTED	Une erreur inattendue s’est produite.
TAPI_E_REGISTRY_SETTING_CORRUPT	Les paramètres du Registre pour la traduction d’adresses ne sont pas valides.
TAPI_E_NODRIVER	Il n’existe aucun fournisseur de services TSP capable d’effectuer une traduction pour cette adresse.
TAPI_E_INUSE	La boîte de dialogue est déjà ouverte et en cours d’utilisation.
TAPI_E_INVALADDRESS	L’adresse actuelle n’est pas valide.
TAPI_E_OPERATIONFAILED	TAPI n’a pas pu terminer l’opération.

Remarques

L’application doit utiliser SysAllocString pour allouer de la mémoire pour pAddressIn et utiliser SysFreeString pour libérer la mémoire lorsque la variable n’est plus nécessaire.

La méthode TranslateDialog est un wrapper COM pour la fonction LineTranslateDialog TAPI 2.1.