Estructura LINELOCATIONENTRY (tapi.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Header | tapi.h |