lineTranslateDialog 函数 (tapi.h)

项目
08/26/2023

lineTranslateDialog 函数显示一个应用程序模式对话框，该对话框允许用户更改要拨打的电话号码的当前位置、调整位置和呼叫卡参数，以及查看效果。

语法

LONG lineTranslateDialog(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  HWND     hwndOwner,
  LPCSTR   lpszAddressIn
);

参数

hLineApp

lineInitializeEx 返回的应用程序句柄。如果应用程序尚未调用 lineInitializeEx 函数，它可以将 hLineApp 参数设置为零。

dwDeviceID

要拨打呼叫所依据的线路设备的设备标识符，以便不同线路上的拨号过程的变化可以应用于转换过程。

dwAPIVersion

应用程序支持的 TAPI 的最高版本 (不一定是 dwDeviceID) 指示的线路设备上 lineNegotiateAPIVersion 协商的值。

hwndOwner

对话框要附加到的窗口的句柄。可以是 NULL 值，指示函数期间创建的任何窗口都应没有所有者窗口。

lpszAddressIn

指向包含电话号码的 以 null 结尾的字符串的指针，该电话号码在对话框的下半部分用于显示用户更改对位置参数的影响。该数字必须采用规范格式;如果非规范，则不显示对话框的电话号码部分。此指针可以保留 为 NULL，在这种情况下，不显示对话框的电话号码部分。如果 lpszAddressIn 参数包含子地址或名称字段，或者用 CR 和 LF 字符分隔的第一个地址，则对话框中仅使用第一个地址。

返回值

如果请求成功，则返回零;如果发生错误，则返回负错误号。可能的返回值为：

LINEERR_BADDEVICEID、LINEERR_INVALPARAM、LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_INVALPOINTER、LINEERR_INIFILECORRUPT、LINEERR_NODRIVER、LINEERR_INUSE、LINEERR_NOMEM、LINEERR_INVALADDRESS、LINEERR_INVALAPPHANDLE、LINEERR_OPERATIONFAILED。

注解

在 TAPI 2.0 或更高版本中，可以打开此对话框的多个实例。在低于 2.0 的 TAPI 版本中，如果对话框已由另一个应用程序显示，则返回LINEERR_INUSE， (无法打开) 多次。在这些版本中，TAPI 将现有对话框置于最前面，错误指示与当前应用程序传入的地址相关的任何具体信息尚未处理，因为该地址未由函数处理。

应用程序必须在此函数之后调用 lineGetTranslateCaps ，以获取用户对电话地址转换参数所做的任何更改，并调用 lineTranslateAddress 以获取基于用户的新选择的可拨号字符串。

如果任何与地址转换相关的函数 (例如，lineGetTranslateCaps 或 lineTranslateAddress) 返回LINEERR_INIFILECORRUPT，则应用程序应调用 lineTranslateDialog。 lineTranslateDialog 函数检测并更正错误，并向用户报告所执行的操作。