Структура LINETRANSLATEOUTPUT (tapi.h)
Структура LINETRANSLATEOUTPUT описывает результат преобразования адреса. Функция lineTranslateAddress использует эту структуру.
Синтаксис
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;
Члены
dwTotalSize
Общий размер, выделенный для этой структуры данных, в байтах.
dwNeededSize
Размер, необходимый для хранения всей возвращаемой информации в байтах в этой структуре данных.
dwUsedSize
Размер части этой структуры данных, содержащей полезную информацию, в байтах.
dwDialableStringSize
Размер коммутируемой строки в байтах, включая завершающее значение NULL.
dwDialableStringOffset
Смещение от начала этой структуры к преобразованным выходным данным, которые можно передать в lineMakeCall, lineDial или другую функцию, для которой требуется коммутируемая строка. Выходные данные всегда являются строкой, завершаемой null. Дополнительные поля, такие как name и subaddress, включаются в эту выходную строку, если они находились во входной строке. Эта строка может содержать личные сведения, такие как вызовы карта номера. Он не должен отображаться для пользователя, чтобы предотвратить непреднамеренное видимость для неавторизованных лиц. Размер поля определяется dwDialableStringSize.
dwDisplayableStringSize
Размер переведенных выходных данных, которые могут отображаться пользователю, включая признак конца null , в байтах.
dwDisplayableStringOffset
Смещение к преобразованным выходным данным, которые могут отображаться пользователю для подтверждения. Он идентичен DialableString, за исключением того, что вызывающие карта цифры заменяются понятным именем карта заключены в квадратные скобки (например, "[AT&T Card]), а вспомогательные поля, такие как имя и вложенный адрес, удаляются. Используйте соответствующее сообщение в dwDisplayableStringOffset, так как строка может отображаться открыто в диалоговом окне состояния вызова. Эти сведения также следует включить в журналы вызовов. Размер поля определяется параметром dwDisplayableStringSize.
dwCurrentCountry
Код страны или региона, настроенный в CurrentLocation. Это значение может использоваться для управления отображением с помощью приложения определенных элементов пользовательского интерфейса, для локального обнаружения хода выполнения вызова и для других целей.
dwDestCountry
Целевой код страны или региона переведенного адреса. Это значение может быть передано параметру dwCountryCodeобъекта lineMakeCall и других функций набора номера (чтобы правильно обнаруживать тоны хода выполнения вызова в целевой стране или регионе, например сигнал занятости). Если адрес назначения, передаваемый в lineTranslateAddress , не имеет канонического формата, это поле равно нулю.
dwTranslateResults
Информация, полученная из процесса перевода, которая может помочь приложению в представлении элементов пользовательского интерфейса. В этом поле используется одна из констант LINETRANSLATERESULT_.
Комментарии
Эту структуру нельзя расширить.
Требования
| Требование | Значение |
|---|---|
| Заголовок | tapi.h |