Net.Data 語言環境參考手冊

dtw_cleanup()

如果您使用 dtw_initialize() 來起始設定語言環境， 則使用 dtw_cleanup() 介面函數來清除語言環境。 例如，切斷與資料庫的連線，或是釋放變數。這個介面函數是選用性的。

在處理 Net.Data 要求時，一旦 Net.Data 處理程序結束， 或是發生錯誤，而使 Net.Data 停止處理巨集檔時， Net.Data 會呼叫語言環境的 dtw_cleanup() 介面函數。

如果清除處理發生異常的話， Net.Data 會將 dtw_lei 結構中的旗號欄位設定為 DTW_END_ABNORMAL。 下列異常狀況提供您於何時使用 dtw_cleanup() 的範例：

• 語言環境介面函數利用設定 dtw_lei 結構中的旗號欄位的 DTW_LE_FATAL_ERROR 位元， 來指示發生嚴重錯誤。

• Net.Data 發現無法回復的錯誤。

• Net.Data 巨集訊息區塊處理造成一個跳出。

如果語言環境的介面函數使用要在介面函數之間傳遞的參數來設定 le_opaque_data 欄位， 請在處理程序結束時，用 dtw_cleanup() 來釋放欄位。

這個介面函數不會影響訊息區塊處理。如果回覆值不是 0，就會發出預設的訊息； 如果沒有預設訊息的存在，巨集處理器就會發出警告訊息。