PHONE_REMOVE消息

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

            

参数

hDevice

保留。 设置为零。

dwCallbackInstance

保留。 设置为零。

dwParam1

已删除的电话设备的标识符。

dwParam2

保留。 设置为零。

dwParam3

保留。 设置为零。

返回值

没有返回值。

备注

向应用程序 TAPI 2.0 或更高版本发送 PHONE_REMOVE 消息。 这会通知他们设备已从系统中删除。 如果应用程序打开了电话 ,则PHONE_REMOVE 消息前面是每个电话句柄上的 PHONE_CLOSE 消息。 此消息将发送到所有支持 TAPI 版本 2.0 或更高版本的应用程序,这些应用程序已调用 phoneInitializeEx,包括那些当时没有任何手机设备打开的应用程序。

较旧的应用程序 (协商 TAPI 1.4 或更早版本) 将发送指定 PHONESTATE_REMOVED PHONE_STATE消息,后跟 PHONE_CLOSE 消息。 但是,与 PHONE_REMOVE 消息不同,这些较旧的应用程序只有在手机被删除时打开手机时才能接收这些消息。 如果他们没有打开手机,则他们唯一指示设备已被移除的指示将是在尝试访问设备时收到PHONEERR_NODEVICE。

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

注意

实现:在从服务提供商收到PHONE_REMOVE消息后,由 TAPI 返回此PHONEERR_NODEVICE消息;不会使用该电话设备标识符向该服务提供商发出进一步的呼叫。

要求

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

另请参阅

PHONE_CLOSE

PHONE_STATE

phoneInitialize

phoneInitializeEx