TUISPI_providerInstall 函数 (tspi.h)
实现TUISPI_providerInstall函数是服务提供商将提供程序的任何其他“部分”安装到正确的目录中的机会， (或至少验证它们是否存在) 并设置提供程序所需的注册表项。 此函数使 版本 2.0 及更高版本中TSPI_providerInstall函数已过时， (版本 1.4 及更早版本中) 支持。
如果服务提供商需要注册表中任何专用定义的条目才能正确操作，则此时必须安装它们。
实现是可选的。
语法
LONG TSPIAPI TUISPI_providerInstall(
TUISPIDLLCALLBACK lpfnUIDLLCallback,
HWND hwndOwner,
DWORD dwPermanentProviderID
);
参数
lpfnUIDLLCallback
指向 UI DLL 可以调用的函数的指针，以便与服务提供商 DLL 通信，以获取显示对话框所需的信息。
hwndOwner
父窗口的句柄，函数可在其中创建安装期间所需的任何对话框窗口。
dwPermanentProviderID
服务提供商的永久提供程序标识符。
返回值
如果函数成功，则返回零;如果发生错误，则返回错误号。 可能的返回值如下所示：
LINEERR_OPERATIONFAILED、LINEERR_INIFILECORRUPT、LINEERR_NOMEM。 LINEERR_INVALPARAM。
注解
此函数必须使系统保持一致状态。 它应运行到完成，不允许用户在部分完成安装时中止安装。 如果安装失败，提供商负责“收回”已执行的操作并返回错误。 这可能意味着在安装开始之前进行预扫描以验证是否可以完成安装。
在安装服务提供程序期间，可以多次调用此函数，直到调用 TUISPI_providerRemove。 但是，如果服务提供商不需要或不支持提供程序的多个实例，则会返回 LINEERR_常量 LINEERR_NOMULTIPLEINSTANCE。
TAPI 级别的相应函数是 lineAddProvider。 LINE_CREATE消息通知正在运行的应用程序动态重新配置。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | tspi.h |