Compartir a través de

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

  • Artículo

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.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado tapi3if.h (incluya Tapi3.h)
Library Uuid.lib
Archivo DLL Tapi3.dll

Consulte también

Address (objeto)

Direcciones que se pueden marcar

ITAddressTranslation