Estructura LINETRANSLATEOUTPUT (tapi.h)

Artículo
03/02/2024

La estructura LINETRANSLATEOUTPUT describe el resultado de una traducción de direcciones. La función lineTranslateAddress usa esta estructura.

Sintaxis

typedef struct linetranslateoutput_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwDialableStringSize;
  DWORD dwDialableStringOffset;
  DWORD dwDisplayableStringSize;
  DWORD dwDisplayableStringOffset;
  DWORD dwCurrentCountry;
  DWORD dwDestCountry;
  DWORD dwTranslateResults;
} LINETRANSLATEOUTPUT, *LPLINETRANSLATEOUTPUT;

Miembros

dwTotalSize

Tamaño total asignado a esta estructura de datos, en bytes.

dwNeededSize

Tamaño necesario para que esta estructura de datos contenga toda la información devuelta, en bytes.

dwUsedSize

Tamaño de la parte de esta estructura de datos que contiene información útil, en bytes.

dwDialableStringSize

Cadena de marcado de tamaño, en bytes, incluida la terminación NULL.

dwDialableStringOffset

Desplazamiento desde el principio de esta estructura hasta la salida traducida que se puede pasar a lineMakeCall, lineDial u otra función que requiera una cadena de marcado. La salida siempre es una cadena terminada en null. Los campos auxiliares, como name y subaddress, se incluyen en esta cadena de salida si estaban en la cadena de entrada. Esta cadena puede contener información privada, como números de tarjeta de llamada. No debe mostrarse al usuario para evitar la visibilidad involuntaria de personas no autorizadas. El tamaño del campo se especifica mediante dwDialableStringSize.

dwDisplayableStringSize

Tamaño de la salida traducida que se puede mostrar al usuario, incluido el terminador NULL , en bytes.

dwDisplayableStringOffset

Desplazamiento a la salida traducida que se puede mostrar al usuario para su confirmación. Es idéntico a DialableString, excepto que los dígitos de la tarjeta de llamada se reemplazan por el nombre descriptivo de la tarjeta entre corchetes (por ejemplo, "[AT&tarjeta T]") y se quitan campos auxiliares como nombre y subdirecciones. Use un mensaje adecuado en dwDisplayableStringOffset, ya que la cadena puede mostrarse públicamente en el cuadro de diálogo estado de la llamada. Esta información también es adecuada para incluir en los registros de llamadas. DwDisplayableStringSize especifica el tamaño del campo.

dwCurrentCountry

Código de país o región configurado en CurrentLocation. Este valor se puede usar para controlar la presentación por parte de la aplicación de determinados elementos de la interfaz de usuario, para la detección de tono de progreso de llamadas locales y para otros fines.

dwDestCountry

Código de país o región de destino de la dirección traducida. Este valor se puede pasar al parámetro dwCountryCode de lineMakeCall y otras funciones de marcado (para que se detecten correctamente los tonos de progreso de la llamada del país o región de destino, como una señal ocupada). Este campo se establece en cero si la dirección de destino pasada a lineTranslateAddress no está en formato canónico.

dwTranslateResults

Información derivada del proceso de traducción, que puede ayudar a la aplicación a presentar elementos de la interfaz de usuario. Este campo usa una de las LINETRANSLATERESULT_ constantes.