通过

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 方法是 TAPI 2.1 LineTranslateAddress 函数的 COM 包装器。

TAPI 在 TranslateAddress 返回的 ITAddressTranslationInfo 接口上调用 AddRef 方法。 应用程序必须在 ITAddressTranslationInfo 接口上调用 Release，以释放与之关联的资源。

要求

要求 值
目标平台 Windows
标头 tapi3if.h (包括 Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

另请参阅

Address 对象

可拨号地址

ITAddressTranslation