LINE_REMOVE消息

发送 TAPI LINE_REMOVE 消息以通知应用程序从线路设备的系统) 删除 (删除。 通常,这不用于临时删除,例如提取 PCMCIA 设备,而仅用于永久删除,如果重新初始化 TAPI,服务提供商将不再报告设备。

            

参数

hDevice

保留。 设置为零。

dwCallbackInstance

保留。 设置为零。

dwParam1

已删除的线路设备的标识符。

dwParam2

保留。 设置为零。

dwParam3

保留。 设置为零。

返回值

没有返回值。

备注

支持 TAPI 2.0 或更高版本的应用程序将发送 LINE_REMOVE 消息。 这会通知他们设备已从系统中删除。 如果应用程序打开了LINE_REMOVE消息,则每个行句柄上都带有LINE_CLOSE消息。 此消息将发送到所有支持 TAPI 2.0 或更高版本的应用程序,这些应用程序已调用 lineInitializeEx,包括那些当时没有任何线路设备打开的应用程序。

较旧的应用程序将发送一条 指定LINEDEVSTATE_REMOVED LINE_LINEDEVSTATE 消息,后跟一条LINE_CLOSE消息。 但是,与 LINE_REMOVE 消息不同,这些较旧的应用程序只有在删除行时打开行时才能接收这些消息。 如果他们没有打开该行,则他们尝试访问设备时收到LINEERR_NODEVICE错误的唯一指示是设备已被移除。

删除设备后,任何按设备标识符访问设备的尝试都会导致LINEERR_NODEVICE错误。 关闭所有 TAPI 应用程序以便 TAPI 可以重启后,当 TAPI 重新初始化时,已删除的设备不再占用设备标识符。

注意

实现:返回此LINEERR_NODEVICE的 TAPI;从服务提供商收到 LINE_REMOVE 消息后;不会使用该线路设备标识符对该服务提供商进行进一步调用。

要求

要求
TAPI 版本
需要 TAPI 2.0 或更高版本
标头
Tapi.h

另请参阅

LINE_CLOSE

LINE_LINEDEVSTATE

lineInitializeEx