TUISPI_lineConfigDialog 函数 (tspi.h)

项目
03/13/2024

TUISPI_lineConfigDialog函数使指定线路设备的提供程序将模式对话框显示为 hwndOwner 的子窗口，以允许用户配置与线路设备相关的参数。此函数使 TSPI_lineConfigDialog 函数在版本 2.0 及更高版本中已过时， (版本 1.4 及更早版本) 中受支持。

实现是可选的。

语法

LONG TSPIAPI TUISPI_lineConfigDialog(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  DWORD             dwDeviceID,
  HWND              hwndOwner,
  LPCWSTR           lpszDeviceClass
);

参数

lpfnUIDLLCallback

指向 UI DLL 可以调用的函数的指针，以便与服务提供程序 DLL 通信，以获取显示对话框以及将更新的配置发送到服务提供程序所需的信息。

dwDeviceID

要配置的线路设备。

hwndOwner

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

lpszDeviceClass

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

返回值

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

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

注解

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

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