Поделиться через

Метод ITAddressTranslation::TranslateDialog (tapi3if.h)

  • Статья

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

Синтаксис

HRESULT TranslateDialog(
  [in] TAPIHWND hwndOwner,
  [in] BSTR     pAddressIn
);

Параметры

[in] hwndOwner

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

[in] pAddressIn

Указатель на BSTR , содержащий номер телефона, который используется для отображения влияния изменений пользователя на параметры расположения. Число должно быть в каноническом формате. Для этого указателя можно оставить значение NULL, и в этом случае часть номера телефона в диалоговом окне не отображается. Если параметр pAddressIn содержит подадрес или поле имени или дополнительные адреса, отделенные от первого адреса символами ASCII CR и LF, в диалоговом окне используется только первый адрес.

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

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Метод успешно выполнен.
E_INVALIDARG
 Параметр hwndOwner не является допустимым дескриптором или параметр pAddressIn не является допустимым номером телефона.
E_POINTER
 Параметр pAddressIn не является допустимым указателем.
E_OUTOFMEMORY
 Для выполнения операции недостаточно памяти.
E_UNEXPECTED
 Произошла непредвиденная ошибка.
TAPI_E_REGISTRY_SETTING_CORRUPT
 Недопустимые параметры реестра для преобразования адресов.
TAPI_E_NODRIVER
 TSP не существует, который может выполнять преобразование для этого адреса.
TAPI_E_INUSE
 Диалоговое окно уже открыто и используется.
TAPI_E_INVALADDRESS
 Текущий адрес недопустим.
TAPI_E_OPERATIONFAILED
 TAPI не удалось завершить операцию.

Комментарии

Приложение должно использовать SysAllocString для выделения памяти для pAddressIn и использовать SysFreeString для освобождения памяти, когда переменная больше не нужна.

Метод TranslateDialog является оболочкой COM для функции LINETranslateDialog TAPI 2.1.

Требования

Требование Значение
Целевая платформа Windows
Header tapi3if.h (включая Tapi3.h)
Библиотека Uuid.lib
DLL Tapi3.dll

См. также раздел

Объект Address

ITAddressTranslation

LineTranslateDialog