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_providerInitTSPI_providerShutdown) 之间调用此函数。

影响通过 TSPI 可见的行为的任何更改都应仅在下一 TSPI_providerInit重新启动服务提供程序时生效。

调用安装命令时,Windows Telephony 在版本 1.4 及更早版本中提供的 Telephony 控制面板 实用工具会调用此函数。

TAPI 级别没有直接对应的函数。 在 TAPI 中,应用程序可以访问 函数 lineConfigDialogphoneConfigDialog,这些函数允许在安装后配置特定线路或电话的参数。

要求

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

另请参阅

TSPI_lineConfigDialog

TSPI_phoneConfigDialog

TSPI_providerInstall

TSPI_providerRemove

TUISPI_providerConfig