lineConfigDialog 函数 (tapi.h)

项目
08/26/2023

lineConfigDialog 函数使指定线路设备的提供程序显示一个对话框 (附加到应用程序的 hwndOwner) ，以允许用户配置与线路设备相关的参数。

语法

LONG lineConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

参数

dwDeviceID

要配置的线路设备的标识符。

hwndOwner

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

lpszDeviceClass

指向以 null 结尾的字符串的指针，该字符串标识设备类名称。此设备类允许应用程序选择适用于该设备类的配置信息的特定子屏幕。此参数是可选的，可以保留 NULL 或空，在这种情况下，会选择最高级别的配置。

返回值

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

LINEERR_BADDEVICEID、LINEERR_NOMEM、LINEERR_INUSE、LINEERR_OPERATIONFAILED、LINEERR_INVALDEVICECLASS、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPARAM、LINEERR_UNINITIALIZED、LINEERR_INVALPOINTER、LINEERR_OPERATIONUNAVAIL、LINEERR_NODEVICE。

注解

lineConfigDialog 函数使服务提供程序显示一个模式对话框， (附加到应用程序) 的 hwndOwner，以允许用户配置与 dwDeviceID 指定的行相关的参数。 lpszDeviceClass 参数允许应用程序选择适用于用户感兴趣的设备类的配置信息的特定子屏幕;允许的字符串与 lineGetID 的字符串相同。例如，如果行支持 Comm API，将“COMM”作为 lpszDeviceClass 传递会导致提供程序显示专门与 Comm (相关的参数，或者至少从多级配置对话框链中的相应点开始，因此用户无需“挖掘”即可) 查找感兴趣的参数。

lpszDeviceClass 参数将为“tapi/line”、“”或 NULL，使提供程序显示行的最高级别配置。