lineAddProvider 函数 (tapi.h)

项目
03/04/2024

lineAddProvider 函数将新的电话服务提供商安装到电话系统中。

语法

LONG lineAddProvider(
  LPCSTR  lpszProviderFilename,
  HWND    hwndOwner,
  LPDWORD lpdwPermanentProviderID
);

参数

lpszProviderFilename

指向的指针

以 null 结尾的字符串，其中包含要添加的服务提供程序的路径。

hwndOwner

窗口的句柄，其中需要作为安装过程的一部分显示的任何对话框 (例如，由服务提供商的 TSPI_providerInstall 函数) 附加。可以为 NULL ，表示在函数期间创建的任何窗口都应没有所有者窗口。

lpdwPermanentProviderID

指向接收新安装的服务提供商的永久提供程序标识符的变量的指针。

返回值

如果请求成功，则返回零;如果发生错误，则返回负错误号。可能的返回值为：

LINEERR_INIFILECORRUPT、LINEERR_INVALPARAM、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_NOMULTIPLEINSTANCE、LINEERR_OPERATIONFAILED。

注解

在此函数调用期间，TAPI 会进行检查，以确保它可以通过调用其 TSPI_providerInstall 函数来访问服务提供商;如果此操作不成功 (找不到 DLL 或函数，或者 如果TSPI_providerInstall 返回错误) ，则函数将失败，并且不会将提供程序添加到电话系统。如果此操作成功，并且电话系统处于活动状态 (一个或多个应用程序已调用 lineInitialize 或 lineInitializeEx) ，则 TAPI 不会尝试启动新添加的服务提供商。相反，为了激活新的服务提供商，TAPI 会发出重启 Windows 的消息。激活成功后，应用程序将通过 LINE_CREATE 或 PHONE_CREATE 消息或请求重新初始化 (LINE_LINEDEVSTATE 消息（如果应用程序不支持 CREATE 消息) ）创建的任何新设备通知应用程序。

此函数不复制任何文件，不复制服务提供程序 DLL 本身或任何支持文件;管理添加提供程序的应用程序必须确保将提供程序安装在 TAPI (可在其中找到的目录中，例如，\WINDOWS、\WINDOWS\SYSTEM 或路径) 的其他位置。