phoneConfigDialog 函数使指定电话设备的提供程序显示模式对话框(附加到应用程序的 hwndOwner 参数),允许用户配置与 dwDeviceID指定的电话设备相关的参数。
语法
LONG phoneConfigDialogW(
DWORD dwDeviceID,
HWND hwndOwner,
LPCWSTR 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,使提供程序显示手机的最高级别配置。
注意
tapi.h 标头将 phoneConfigDialog 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的
要求
要求 | 价值 |
---|---|
目标平台 | 窗户 |
标头 | tapi.h |
库 | Tapi32.lib |
DLL | Tapi32.dll |