Método ITAddressTranslation::TranslateAddress (tapi3if.h)

Artículo
03/02/2024

El método TranslateAddress crea la interfaz de información de traducción de direcciones. El objetivo principal del método TranslateAddress es obtener la cadena pDestAddress (dirección de marcado) necesaria como parámetro para ITAddress::CreateCall. El método TranslateAddress devuelve indirectamente la dirección de marcado, como una de las propiedades de un objeto ITAddressTranslationInfo .

Sintaxis

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

Parámetros

[in] pAddressToTranslate

Puntero a BSTR que contiene la dirección que requiere traducción.

[in] lCard

Tarjeta de llamada usada para la traducción.

[in] lTranslateOptions

Indicador de las opciones de traducción, consulte LINETRANSLATEOPTION__Constants.

[out] ppTranslated

Puntero a la interfaz ITAddressTranslationInfo recién creada.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Significado
S_OK	El método se realizó correctamente.
E_POINTER	El parámetro ppTranslated no es un puntero válido.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.
E_UNEXPECTED	Error en el método por motivos desconocidos.
E_INVALIDARG	El valor lTranslateOptions no es válido.
TAPI_E_NODRIVER	Esta dirección no tiene ningún TSP asociado.
TAPI_E_REGISTRY_SETTING_CORRUPT	El registro está dañado.
TAPI_E_OPERATIONFAILED	Error en el método con TAPI.
TAPI_E_RESOURCEUNAVAIL	El TSP no está disponible.
TAPI_E_INVALCARD	El número de tarjeta no es válido.

Comentarios

La aplicación debe usar SysAllocString para asignar memoria para pAddressToTranslate y usar SysFreeString para liberar la memoria cuando la variable ya no sea necesaria.

El método TranslateAddress es un contenedor COM para la función LineTranslateAddress tapI 2.1.

TAPI llama al método AddRef en la interfaz ITAddressTranslationInfo devuelta por TranslateAddress. La aplicación debe llamar a Release en la interfaz ITAddressTranslationInfo para liberar recursos asociados.