TSPI_providerConfig 函数 (tspi.h)
TSPI_providerConfig 函数已过时。 TAPI 版本 1.4 或更早版本的服务提供商可以实现此 TSPI 函数。 TAPI 版本 2.0 或更高版本的 TSP 实现 TUISPI_providerConfig。
TSPI_providerConfig函数从用户收集配置信息。 它可以使用对话框,并且此对话框可以包含与其他 API 关联的子对话框, (例如用于设置特定设备的 Comm/datamodem) 。
语法
LONG TSPIAPI TSPI_providerConfig(
HWND hwndOwner,
DWORD dwPermanentProviderID
);
参数
hwndOwner
父窗口的句柄,函数可在其中创建配置期间所需的任何对话框窗口。
dwPermanentProviderID
服务提供商的永久提供程序标识符。
返回值
如果函数成功,则返回零;如果发生错误,则返回错误号。 可能的返回值如下所示:
LINEERR_OPERATIONFAILED,LINEERR_NOMEM。
注解
在使用服务提供程序时,可以在 (调用 TSPI_providerInit 和 TSPI_providerShutdown) 之间调用此函数。
影响通过 TSPI 可见的行为的任何更改都应仅在下一 TSPI_providerInit重新启动服务提供程序时生效。
调用安装命令时,Windows Telephony 在版本 1.4 及更早版本中提供的 Telephony 控制面板 实用工具会调用此函数。
TAPI 级别没有直接对应的函数。 在 TAPI 中,应用程序可以访问 函数 lineConfigDialog 和 phoneConfigDialog,这些函数允许在安装后配置特定线路或电话的参数。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tspi.h |