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 或更高版本 |
标头 |
|