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 或更新版本 |
標頭 |
|