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訊息之後,會傳回此PHONEERR_NODEVICE訊息的 TAPI;使用該電話裝置識別碼的服務提供者不會再撥打任何電話。

規格需求

需求
TAPI 版本
需要 TAPI 2.0 或更新版本
標頭
Tapi.h

另請參閱

PHONE_CLOSE

PHONE_STATE

phoneInitialize

phoneInitializeEx