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

Article
03/02/2024

La méthode TranslateAddress crée l’interface d’informations de traduction d’adresses. L’objectif principal de la méthode TranslateAddress est d’obtenir la chaîne pDestAddress (adresse de numérotation) nécessaire en tant que paramètre pour ITAddress ::CreateCall. La méthode TranslateAddress renvoie indirectement l’adresse de numérotation, en tant que l’une des propriétés d’un objet ITAddressTranslationInfo .

Syntaxe

HRESULT TranslateAddress(
  [in]  BSTR                     pAddressToTranslate,
  [in]  long                     lCard,
  [in]  long                     lTranslateOptions,
  [out] ITAddressTranslationInfo **ppTranslated
);

Paramètres

[in] pAddressToTranslate

Pointeur vers BSTR contenant l’adresse qui nécessite une traduction.

[in] lCard

Appel carte utilisé pour la traduction.

[in] lTranslateOptions

Indicateur des options de traduction, voir LINETRANSLATEOPTION__Constants.

[out] ppTranslated

Pointeur vers l’interface ITAddressTranslationInfo nouvellement créée.

Valeur retournée

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

Valeur	Signification
S_OK	La méthode a réussi.
E_POINTER	Le paramètre ppTranslated n’est pas un pointeur valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.
E_UNEXPECTED	La méthode a échoué pour des raisons inconnues.
E_INVALIDARG	La valeur lTranslateOptions n’est pas valide.
TAPI_E_NODRIVER	Aucun TSP n’est associé à cette adresse.
TAPI_E_REGISTRY_SETTING_CORRUPT	Le Registre est endommagé.
TAPI_E_OPERATIONFAILED	La méthode a échoué avec TAPI.
TAPI_E_RESOURCEUNAVAIL	Le TSP n’est pas disponible.
TAPI_E_INVALCARD	Le numéro carte n’est pas valide.

Remarques

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

La méthode TranslateAddress est un wrapper COM pour la fonction LineTranslateAddress TAPI 2.1.

TAPI appelle la méthode AddRef sur l’interface ITAddressTranslationInfo retournée par TranslateAddress. L’application doit appeler Release sur l’interface ITAddressTranslationInfo pour libérer les ressources qui lui sont associées.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	tapi3if.h (inclure Tapi3.h)
Bibliothèque	Uuid.lib
DLL	Tapi3.dll

Voir aussi

Objet Address

Adresses accessibles

ITAddressTranslation

Partager via