phoneConfigDialog 函数 (tapi.h)

项目
03/13/2024

phoneConfigDialog 函数使指定电话设备的提供程序显示模式对话框， (附加到应用程序的 hwndOwner 参数) ，允许用户配置与 dwDeviceID 指定的电话设备相关的参数。

语法

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

参数

dwDeviceID

要配置的电话设备的标识符。

hwndOwner

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

lpszDeviceClass

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

返回值

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

PHONEERR_BADDEVICEID、PHONEERR_NOMEM、PHONEERR_INUSE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPARAM、PHONEERR_OPERATIONUNAVAIL、PHONEERR_INVALDEVICECLASS、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPOINTER、PHONEERR_UNINITIALIZED、PHONEERR_NODEVICE。

注解

lpszDeviceClass 参数允许应用程序选择适用于用户感兴趣的设备类的配置信息的特定子屏幕;允许的字符串与 phoneGetID 相同。例如，如果手机支持波形 API，则传递“wave/in”作为 lpszDeviceClass 将导致提供程序显示专门与波形 (相关的参数，或者至少从多级配置对话框链中的相应点开始，而无需) 搜索相关参数。

lpszDeviceClass 参数应为“tapi/phone”、“”或 NULL，以便提供程序显示电话的最高级别配置。