TSPI_lineConfigDialog 函数 (tspi.h)

项目
08/26/2023

TSPI_lineConfigDialog 函数已过时。 TAPI 版本 1.4 或更早版本的服务提供商可以实现此 TSPI 函数。 TAPI 版本 2.0 或更高版本的 TSP 实现 TUISPI_lineConfigDialog。

TSPI_lineConfigDialog 函数使指定线路设备的提供程序将模式对话框显示为 hwndOwner 的子窗口，以允许用户配置与线路设备相关的参数。

语法

LONG TSPIAPI TSPI_lineConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

参数

dwDeviceID

要配置的线路设备。

hwndOwner

要在其中放置对话框窗口的父窗口的句柄。

lpszDeviceClass

指向以 null 结尾的 Unicode 字符串的指针，该字符串标识设备类名称。此设备类允许调用方选择适用于该设备类的配置信息的特定子屏幕。如果此参数为 NULL 或空字符串，则应选择最高级别配置对话框。允许的字符串与 TSPI_lineGetID相同。例如，如果行支持 Comm API，将 comm/datamodem 作为 lpszDeviceClass 传递会导致提供程序显示专门与 Comm (相关的参数，或者至少从多级配置对话框链中的相应点开始，以便用户无需搜索即可找到所需的参数。)

返回值

如果函数成功，则返回零;如果发生错误，则返回错误号。可能的返回值如下所示：

LINEERR_INUSE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALDEVICECLASS、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL。

注解

该过程必须更新 Win.ini 文件中的 [Windows Telephony] 部分，如果对 Telephon.ini 文件进行任何更改，导致 LINEDEVCAPS 或 LINEADDRESSCAPS 中报告的线路或地址功能发生更改，或者创建或删除线路设备，则该过程必须广播WM_WININICHANGE消息。

此函数 (TSPI_lineConfigDialog) 仅在行关闭时调用，没有任何限制。但是，每个提供程序本身可以施加此类限制。调用 TSPI_lineConfigDialog 时，提供程序可能会向用户发出消息“该行正由一个或多个应用程序使用。在使用行时，不能更改行配置“ (并返回错误消息LINEERR_INUSE) 。但是，某些配置可以安全地“动态”更改，尤其是与媒体类型相关的配置 (，例如调制解调器错误控制协议) ，尤其是在当前未使用该媒体类型时。提供程序可以允许在行打开时更改这些选项。

不应允许用户更改使用 LINEDEVCAPS 或 LINEADDRESSCAPS 返回的值的任何内容，而不首先强行关闭该行，以指示应用程序必须调用返回这些结构的函数才能获得准确的信息。