TSPI_phoneConfigDialog 函数 (tspi.h)
TSPI_phoneConfigDialog 函数已过时。 TAPI 版本 1.4 或更早版本的服务提供商可以实现此 TSPI 函数。 TAPI 版本 2.0 或更高版本的 TSP 实现 TUISPI_phoneConfigDialog。
TSPI_phoneConfigDialog 函数使指定电话设备的提供程序将模式对话框显示为 hwndOwner 的子窗口，以允许用户配置与电话设备相关的参数。
语法
LONG TSPIAPI TSPI_phoneConfigDialog(
DWORD dwDeviceID,
HWND hwndOwner,
LPCSTR lpszDeviceClass
);
参数
dwDeviceID
要配置的电话设备。
hwndOwner
要在其中放置对话框窗口的父窗口的句柄。
lpszDeviceClass
指向以 null 结尾的 Unicode 字符串的指针，该字符串标识设备类名称。 此设备类允许调用方选择适用于该设备类的配置信息的特定子屏幕。 如果此参数为 NULL 或空字符串，则选择最高级别配置对话框。
返回值
如果函数成功，则返回零;如果发生错误，则返回错误号。 可能的返回值如下所示：
PHONEERR_BADDEVICEID、PHONEERR_NOMEM、PHONEERR_INUSE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPARAM、PHONEERR_OPERATIONUNAVAIL、PHONEERR_INVALDEVICECLASS、PHONEERR_RESOURCEUNAVAIL。
注解
TSPI_phoneConfigDialog 会导致服务提供商将模式对话框显示为 hWndOwner 的子窗口，以允许用户配置与 dwDeviceID 指定的电话相关的参数。 lpszDeviceClass 参数允许应用程序选择适用于用户感兴趣的设备类的配置信息的特定子屏幕。 允许的字符串与 TSPI_phoneGetID相同。 例如，如果手机支持 Comm API，将 comm/datamodem 作为 lpszDeviceClass 传递会导致提供程序显示专门与 Comm (相关的参数，或者至少从多级配置对话框链中的相应点开始，以便用户无需搜索即可) 查找所需的参数。 szDeviceClass 参数应为“tapi/phone”、“”或 NULL，使提供程序显示电话的最高级别配置。
该过程必须更新 Win.ini 文件中的 [Windows Telephony] 部分，如果对 Telephon.ini 进行任何更改，这些更改会影响应用程序 (（如 PHONECAPS) ）可见的结构的内容，或者创建或删除了电话设备，则该过程必须更新WM_WININICHANGE消息。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | tspi.h |