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

Статья
08/26/2023

Метод 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	Недопустимый номер карта.

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