TSPI_phoneClose函式 (tspi.h)
TSPI_phoneClose函式在完成或中止裝置上所有未完成的非同步作業之後,關閉指定的開啟電話裝置。
語法
LONG TSPIAPI TSPI_phoneClose(
HDRVPHONE hdPhone
);
參數
hdPhone
要關閉之手機的服務提供者不透明控制碼。 成功關閉手機之後,此控制碼就不再有效。
傳回值
如果函式成功,則傳回零,如果發生錯誤,則傳回錯誤號碼。 可能的傳回值如下所示:
PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM、PHONEERR_OPERATIONUNAVAIL、PHONEERR_RESOURCEUNAVAIL。
備註
服務提供者必須針對每個非同步作業報告完成。 如果針對有未完成非同步作業的撥打電話此程式,則此作業應該會在傳回此程式之前,以適當的結果或錯誤碼回報。 一般而言,TAPI 會依序等候這些專案完成。 不過,服務提供者應該準備好在「中止」或「緊急關機」的情況下,處理 對TSPI_phoneClose 的早期呼叫。
在此程式傳回之後,服務提供者必須在手機上不報告任何進一步的事件。 手機的服務提供者不透明控制碼會變成無效。
服務提供者必須在手機開啟時放棄它所保留的非可共用資源。 例如,關閉透過 comm 埠存取的手機,數據機應該會導致關閉 comm 埠,使其可供其他應用程式使用。
此函式應一律會成功,但在某些情況下除外。 大部分的呼叫端可能會忽略傳回碼,因為它們無法補償發生的任何錯誤。 指定的傳回值比任何其他專案更適用于開發診斷用途的諮詢。
規格需求
目標平台 | Windows |
標頭 | tspi.h |