TUISPI_phoneConfigDialog函数 (tspi.h)

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

实现是可选的。

语法

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

参数

lpfnUIDLLCallback

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

dwDeviceID

要配置的电话设备。

hwndOwner

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

lpszDeviceClass

指向以 null 结尾的 Unicode 字符串的指针,该字符串标识设备类名称。 此设备类允许调用方选择适用于该设备类的配置信息的特定子屏幕。 如果此参数为 NULL 或空字符串,则选择最高级别配置对话框。

返回值

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

PHONEERR_BADDEVICEID、PHONEERR_NOMEM、PHONEERR_INUSE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPARAM、PHONEERR_OPERATIONUNAVAIL、PHONEERR_INVALDEVICECLASS、PHONEERR_RESOURCEUNAVAIL。

注解

lpszDeviceClass 参数允许应用程序选择适用于用户感兴趣的设备类的配置信息的特定子屏幕。 允许的字符串与 TSPI_phoneGetID相同。

例如,如果手机支持 Comm API,将 comm/datamodem 作为 lpszDeviceClass 传递会导致提供程序显示专门与 Comm (相关的参数,或者至少从多级配置对话框链中的相应点开始,以便用户无需搜索即可) 查找所需的参数。 szDeviceClass 参数应为“tapi/phone”、“”或 NULL,使提供程序显示电话的最高级别配置。

要求

要求
目标平台 Windows
标头 tspi.h

另请参阅

PHONECAPS

TSPI_phoneGetID