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

Artículo
03/08/2023

El método TranslateDialog muestra un cuadro de diálogo modal de aplicación que permite al usuario cambiar la ubicación actual de un número de teléfono a punto de marcar, ajustar la ubicación y los parámetros de la tarjeta de llamada y ver el efecto.

Sintaxis

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

Parámetros

[in] hwndOwner

Identificador de una ventana a la que se va a adjuntar el cuadro de diálogo. Puede ser un valor NULL para indicar que cualquier ventana creada durante la función no debe tener ninguna ventana de propietario.

[in] pAddressIn

Puntero a BSTR que contiene un número de teléfono que se usa para mostrar el efecto de los cambios del usuario en los parámetros de ubicación. El número debe estar en formato canónico. Este puntero se puede dejar NULL, en cuyo caso no se muestra la parte del número de teléfono del cuadro de diálogo. Si el parámetro pAddressIn contiene un campo de nombre o subaddress o direcciones adicionales separadas de la primera dirección por caracteres ASCII CR y LF, solo se usa la primera dirección en el cuadro de diálogo.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
E_INVALIDARG	El parámetro hwndOwner no es un identificador válido o el parámetro pAddressIn no es un número de teléfono válido.
E_POINTER	El parámetro pAddressIn no es un puntero válido.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.
E_UNEXPECTED	Se ha producido un error inesperado.
TAPI_E_REGISTRY_SETTING_CORRUPT	La configuración del Registro para la traducción de direcciones no es válida.
TAPI_E_NODRIVER	No existe ningún TSP que pueda realizar la traducción para esta dirección.
TAPI_E_INUSE	El cuadro de diálogo ya está abierto y en uso.
TAPI_E_INVALADDRESS	La dirección actual no es válida.
TAPI_E_OPERATIONFAILED	TAPI no pudo completar la operación.

Comentarios

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

El método TranslateDialog es un contenedor COM para la función LineTranslateDialog TAPI 2.1.