lineRemoveProvider 函数 (tapi.h)

lineRemoveProvider 函数从电话系统中删除现有的电话服务提供程序。

语法

LONG lineRemoveProvider(
  DWORD dwPermanentProviderID,
  HWND  hwndOwner
);

参数

dwPermanentProviderID

要删除的服务提供程序的永久提供程序标识符。

hwndOwner

需要作为删除过程一部分显示的任何对话框 (窗口的句柄,例如, 服务提供商TSPI_providerRemove函数) 将附加确认对话框。 可以是 NULL 值,指示函数期间创建的任何窗口都应没有所有者窗口。

返回值

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

LINEERR_INIFILECORRUPT、LINEERR_NOMEM、LINEERR_INVALPARAM、LINEERR_OPERATIONFAILED。

注解

如果 对TSPI_providerRemove 的调用成功,并且电话系统当时处于活动状态,TAPI 将根据哪些设备类型处于活动状态) ,在服务提供商 (调用 lineShutdown 和/或 phoneShutdown 。 在与用户 ) 进行验证后,LINE_CLOSE或 PHONE_CLOSE 消息强制关闭关联设备上的应用程序仍持有的任何线路或电话句柄, (服务提供商最好在 TSPI_providerRemove中发出这些消息。 然后,以前受该提供程序控制的设备被标记为“不可用”,以便应用程序将来尝试按设备标识符引用它们会导致LINEERR_NODRIVER。

要求

要求
目标平台 Windows
标头 tapi.h
Library Tapi32.lib
DLL Tapi32.dll

另请参阅

LINE_CLOSE

PHONE_CLOSE

补充行服务函数

TAPI 2.2 参考概述