TSPI_providerInstall 函数 (tspi.h)
TSPI_providerInstall 函数已过时。 TAPI 版本 1.4 或更早版本的服务提供商可以实现此 TSPI 函数。 TAPI 版本 2.0 或更高版本的 TSP 实现 TUISPI_providerInstall。
TSPI_providerInstall函数将提供程序的任何其他“部分”安装到正确的目录中， (或至少验证它们是否存在) ，为其线路和电话设置提供程序的注册表项，并创建服务提供商所需的任何其他条目。 当按下“添加”按钮时， (Windows Telephony 1.4 及更早版本中提供的电话控制面板实用工具) 调用它。
语法
LONG TSPIAPI TSPI_providerInstall(
HWND hwndOwner,
DWORD dwPermanentProviderID
);
参数
hwndOwner
父窗口的句柄，函数可在其中创建安装期间所需的任何对话框窗口。
dwPermanentProviderID
服务提供商的永久提供程序标识符。
返回值
如果函数成功，则返回零;如果发生错误，则返回错误号。 可能的返回值如下所示：
LINEERR_OPERATIONFAILED、LINEERR_INIFILECORRUPT、LINEERR_NOMEM、LINEERR_INVALPARAM。
注解
在完成服务提供程序在注册表的 [Providers] 部分中的条目后，此函数将完成服务提供程序所需的其他部分的安装。 如果服务提供商需要注册表中任何其他专用定义的条目才能正确操作，则还必须安装它们。 安装此部分及其条目的典型方法是调用 TSPI_providerConfig。
此函数必须使系统保持一致状态。 它应运行到完成，不允许用户在部分完成安装时中止安装。 如果安装失败，提供商负责“收回”已执行的操作并返回错误。 这可能意味着在安装开始之前进行预扫描以验证是否可以完成安装。
在安装服务提供程序期间，只会调用此函数一次，直到调用 TSPI_providerRemove。 必须在任何其他 TSPI 定义的函数之前调用它。
在版本 1.4 及更早版本中随 Windows Telephony 提供的 Telephony 控制面板实用工具调用此函数 (满足外部序列要求，如此处所述) 调用“add”命令时。 它不会为“add”命令调用 TSPI_providerConfig 。
TAPI 级别没有相应的函数。 在该级别，应用程序预期已安装服务提供商。 正在运行的应用程序通过LINE_LINEDEVSTATE或PHONE_STATE消息中的LINEDEVSTATE_REINIT或PHONESTATE_REINIT值通知动态重新配置。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | tspi.h |