通过

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

要求

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

另请参阅

Address 对象

ITAddressTranslation

LineTranslateDialog