Estructura LINELOCATIONENTRY (tapi.h)

Artículo
03/02/2024

La estructura LINELOCATIONENTRY describe una ubicación utilizada para proporcionar un contexto de traducción de direcciones. La estructura LINETRANSLATECAPS puede contener una matriz de estructuras LINELOCATIONENTRY .

Sintaxis

typedef struct linelocationentry_tag {
  DWORD dwPermanentLocationID;
  DWORD dwLocationNameSize;
  DWORD dwLocationNameOffset;
  DWORD dwCountryCode;
  DWORD dwCityCodeSize;
  DWORD dwCityCodeOffset;
  DWORD dwPreferredCardID;
  DWORD dwLocalAccessCodeSize;
  DWORD dwLocalAccessCodeOffset;
  DWORD dwLongDistanceAccessCodeSize;
  DWORD dwLongDistanceAccessCodeOffset;
  DWORD dwTollPrefixListSize;
  DWORD dwTollPrefixListOffset;
  DWORD dwCountryID;
  DWORD dwOptions;
  DWORD dwCancelCallWaitingSize;
  DWORD dwCancelCallWaitingOffset;
} LINELOCATIONENTRY, *LPLINELOCATIONENTRY;

Miembros

dwPermanentLocationID

Permanente. Identifica la ubicación.

dwLocationNameSize

Tamaño, en caracteres, de una cadena de nombre de ubicación terminada en null, incluido el carácter de terminación NULL.

dwLocationNameOffset

Tamaño de desplazamiento, especificado en dwLocationNameSize, desde el principio de la estructura LINETRANSLATECAPS (que contiene esta entrada) a una cadena terminada en null que describe la ubicación de una manera fácil de usar.

dwCountryCode

Código de país o región de la ubicación.

dwCityCodeSize

Tamaño, en caracteres, de la cadena de código de ciudad terminada en null, incluido el carácter de terminación NULL.

dwCityCodeOffset

Offset, especificado en dwCityCodeSize, desde el principio de esta estructura a una cadena terminada en null que especifica el código de ciudad o área asociado a la ubicación. Esta información, con el código de país o región, puede ser utilizada por las aplicaciones para los campos de entrada "predeterminados" para el usuario al escribir números de teléfono, para fomentar la entrada de números canónicos adecuados.

dwPreferredCardID

Tarjeta de llamada preferida al marcar desde esta ubicación.

dwLocalAccessCodeSize

Tamaño, en bytes, de la cadena de código de acceso local, incluido el terminador null .

dwLocalAccessCodeOffset

Tamaño de desplazamiento, especificado en dwLocalAccessCodeSize, desde el principio de la estructura LINETRANSLATECAPS a una cadena terminada en null que contiene el código de acceso que se va a marcar antes de llamar a direcciones en el área de llamada local.

dwLongDistanceAccessCodeSize

Tamaño, en bytes, del código de acceso de larga distancia, incluido el terminador NULL .

dwLongDistanceAccessCodeOffset

Tamaño de desplazamiento, especificado en dwLongDistanceAccessCodeSize, desde el principio de la estructura LINETRANSLATECAPS a una cadena terminada en null que contiene el código de acceso que se va a marcar antes de llamar a direcciones fuera del área de llamada local.

dwTollPrefixListSize

Tamaño, en bytes, del prefijo de peaje, incluido el terminador null .

dwTollPrefixListOffset

Tamaño de desplazamiento, especificado en dwTollPrefixListSize, desde el principio de la estructura LINETRANSLATECAPS a una cadena terminada en null que contiene la lista de prefijos de peaje para la ubicación. La cadena solo contiene prefijos que constan de los dígitos "0" a "9", separados entre sí por un solo carácter "," (coma).

dwCountryID

Identificador del país o región seleccionado para la ubicación. Esto se puede usar con la función lineGetCountry para obtener información adicional sobre el país o región específicos, como el nombre del país o región (el miembro dwCountryCode no se puede usar para este propósito porque los códigos de país o región no son únicos).

dwOptions

Las opciones en vigor para esta ubicación, con valores tomados de las constantes de LINELOCATIONOPTION_.

dwCancelCallWaitingSize

Tamaño, en bytes, de la cadena cancel-call-waiting.

dwCancelCallWaitingOffset

Tamaño de desplazamiento, especificado en dwCancelCallWaitingSize, desde el principio de la estructura LINETRANSLATECAPS a una cadena terminada en null que contiene los dígitos de marcado y los caracteres modificadores que se deben prefijar a la cadena de marcado (después del carácter de pulso/tono) cuando una aplicación establece el bit LINETRANSLATEOPTION_CANCELCALLWAITING en el parámetro dwTranslateOptions de lineTranslateAddress. Si no se define ningún prefijo, dwCancelCallWaitingSize puede establecerse en cero o 1, y dwCancelCallWaitingOffset puede apuntar a una cadena vacía (un solo byte NULL ).

Comentarios

Esta estructura no se puede extender.

Las aplicaciones anteriores se compilan sin tener conocimiento de estos nuevos campos y usan un SIZEOF LINELOCATIONENTRY menor que el nuevo tamaño. Dado que se trata de una matriz en la parte variable de una estructura LINETRANSLATECAPS , es imperativo que las aplicaciones anteriores reciban estructuras LINELOCATIONENTRY en el formato esperado anteriormente o que no puedan indexar correctamente a través de la matriz. La aplicación pasa un parámetro dwAPIVersion con la función lineGetTranslateCaps , que TAPI puede usar para obtener instrucciones para controlar esta situación. La función lineGetTranslateCaps debe usar los miembros y el tamaño LINELOCATIONENTRY que coincidan con la versión de API indicada, al compilar la estructura LINETRANSLATECAPS que se va a devolver a la aplicación.