Функция lineTranslateDialog (tapi.h)

Статья
08/26/2023

Функция lineTranslateDialog отображает модальное диалоговое окно приложения, которое позволяет пользователю изменить текущее расположение номера телефона, который будет набираться, настроить расположение и параметры вызова карта, а также увидеть эффект.

Синтаксис

LONG lineTranslateDialog(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  HWND     hwndOwner,
  LPCSTR   lpszAddressIn
);

Параметры

hLineApp

Дескриптор приложения, возвращенный lineInitializeEx. Если приложение еще не вызывало функцию lineInitializeEx , оно может задать для параметра hLineApp нулевое значение.

dwDeviceID

Идентификатор устройства для устройства линии, с которого предполагается набирать звонок, чтобы к процессу перевода можно было применить различные процедуры набора номера в разных строках.

dwAPIVersion

Самая высокая версия TAPI, поддерживаемая приложением (необязательное значение, согласованное lineNegotiateAPIVersion на устройстве линии, указанном dwDeviceID).

hwndOwner

Дескриптор к окну, к которому будет присоединено диалоговое окно. Может иметь значение NULL , указывающее, что любое окно, созданное во время выполнения функции, не должно иметь окна-владельца.

lpszAddressIn

Указатель на строку с пустым завершением, содержащую номер телефона, который используется в нижней части диалогового окна для отображения влияния изменений пользователя на параметры расположения. Число должно быть в каноническом формате; Если значение неканонично, часть номера телефона в диалоговом окне не отображается. Для этого указателя можно оставить значение NULL. В этом случае часть номера телефона в диалоговом окне не отображается. Если параметр lpszAddressIn содержит поле subaddress или name или дополнительные адреса, отделенные от первого адреса символами CR и LF, в диалоговом окне используется только первый адрес.

Возвращаемое значение

Возвращает ноль при успешном выполнении запроса или отрицательное число ошибки при возникновении ошибки. Возможные возвращаемые значения:

LINEERR_BADDEVICEID, LINEERR_INVALPARAM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INVALPOINTER, LINEERR_INIFILECORRUPT, LINEERR_NODRIVER, LINEERR_INUSE, LINEERR_NOMEM, LINEERR_INVALADDRESS, LINEERR_INVALAPPHANDLE LINEERR_OPERATIONFAILED.

В TAPI версии 2.0 или более поздней можно открыть несколько экземпляров этого диалогового окна. В версиях TAPI, предшествующих версии 2.0, возвращается LINEERR_INUSE, если диалоговое окно уже отображается другим приложением (оно не может быть открыто более одного раза). В этих версиях TAPI выводит существующее диалоговое окно на передний план, а ошибка указывает на то, что все сведения, связанные с адресом, переданным текущим приложением, не были обработаны, так как этот адрес не был обработан функцией .

Приложение должно вызывать lineGetTranslateCaps после этой функции, чтобы получить любые изменения, внесенные пользователем в параметры преобразования адресов телефонии, и вызвать lineTranslateAddress , чтобы получить набираемую строку на основе новых выбранных пользователем вариантов.

Если какая-либо функция, связанная с преобразованием адресов (например, lineGetTranslateCaps или lineTranslateAddress), возвращает LINEERR_INIFILECORRUPT, приложение должно вызвать lineTranslateDialog. Функция lineTranslateDialog обнаруживает ошибки и исправляет их, а также сообщает о выполненных действиях пользователю.