lineConfigDialogA 函数 (tapi.h)

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

语法

LONG lineConfigDialogA(
  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,导致提供程序显示行的最高级别配置。

注意

tapi.h 标头将 lineConfigDialog 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
目标平台 窗户
标头 tapi.h
Tapi32.lib
DLL Tapi32.dll

另请参阅

基本电话服务参考

TAPI 2.2 参考概述

lineGetID