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

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

  • Статья

Метод TranslateAddress создает интерфейс сведений о преобразовании адреса. Основная цель метода TranslateAddress — получить строку pDestAddress (набираемый адрес), необходимую в качестве параметра для ITAddress::CreateCall. Метод TranslateAddress косвенно возвращает доступный для набора адрес в качестве одного из свойств объекта ITAddressTranslationInfo .

Синтаксис

HRESULT TranslateAddress(
  [in]  BSTR                     pAddressToTranslate,
  [in]  long                     lCard,
  [in]  long                     lTranslateOptions,
  [out] ITAddressTranslationInfo **ppTranslated
);

Параметры

[in] pAddressToTranslate

Указатель на BSTR , содержащий адрес, требующий преобразования.

[in] lCard

Вызов карта используется для перевода.

[in] lTranslateOptions

Индикатор параметров перевода см . LINETRANSLATEOPTION__Constants.

[out] ppTranslated

Указатель на созданный интерфейс ITAddressTranslationInfo .

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

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

Значение Значение
S_OK
 Метод успешно выполнен.
E_POINTER
 Параметр ppTranslated не является допустимым указателем.
E_OUTOFMEMORY
 Для выполнения операции недостаточно памяти.
E_UNEXPECTED
 Сбой метода по неизвестным причинам.
E_INVALIDARG
 Недопустимое значение lTranslateOptions .
TAPI_E_NODRIVER
 С этим адресом не связан поставщик служб TSP.
TAPI_E_REGISTRY_SETTING_CORRUPT
 Реестр поврежден.
TAPI_E_OPERATIONFAILED
 Сбой метода с использованием TAPI.
TAPI_E_RESOURCEUNAVAIL
 Поставщик служб TSP недоступен.
TAPI_E_INVALCARD
 Недопустимый номер карта.

Комментарии

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

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

TAPI вызывает метод AddRef в интерфейсе ITAddressTranslationInfo , возвращенном TranslateAddress. Приложение должно вызвать Release в интерфейсе ITAddressTranslationInfo , чтобы освободить связанные с ним ресурсы.

Требования

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

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

Объект Address

Доступные для набора адреса

ITAddressTranslation