phoneClose 函式 (tapi.h)

phoneClose 函式會關閉指定的開啟手機裝置。

語法

LONG phoneClose(
  HPHONE hPhone
);

hPhone

要關閉之已開啟手機裝置的句柄。如果函式成功，句柄就不再有效。

如果要求成功，則傳回零，如果發生錯誤，則傳回負錯誤號碼。可能的傳回值為：

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_OPERATIONFAILED、PHONEERR_RESOURCEUNAVAIL、PHONEERR_OPERATIONUNAVAIL PHONEERR_UNINITIALIZED。

成功關閉開啟的手機裝置之後，實作會將 PHONE_CLOSE 訊息傳送至應用程式。這些訊息也可以因為電話裝置以某種方式回收而未經請求傳送。因此，應用程式應該準備好處理這些未經請求的關閉訊息。在手機裝置關閉時，會隱藏任何未處理的異步回復。