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 |