語言環境介面參考手冊

dtw_getNextRow()

dtw_getNextRow() 介面函數會取回輸入，以進行一次一列的 Net.Data 表格處理。 每當您設定 DTW_LE_CONTINUE 旗號，表示需要為該表格處理其他列的資料時， 就會呼叫這個介面函數。為資料庫語言環境使用 dtw_getNextRow()。

限制：只有 Net.Data 在 OS/400 或 OS/390 作業系統上執行的情況下， 才會呼叫這個介面函數。

發生下列狀況時，Net.Data 會呼叫 dtw_getNextRow()：

• 呼叫語言環境的 dtw_execute() 呼叫順利完成 (傳回 0 值)

• dtw_execute() 介面函數已在 dtw_lei_t 結構中設定 DTW_LE_CONTINUE 旗號。

當 dtw_execute() 函數將 DTW_LE_CONTINUE 旗號設定為 on 時， Net.Data 會執行下列步驟：

1. 為 dtw_execute() 介面函數的回覆值處理訊息區塊。

2. 呼叫語言環境的 dtw_getNextRow() 介面函數，並開始一次一列處理程序。

3. 處理報告區塊

4. 為 dtw_getNextRow() 介面函數的回覆值處理訊息區塊。

5. 判定 dtw_getNextRow() 是否有啟動 DTW_LE_CONTINUE 旗號：

   • 如果有，則在步驟 2 繼續處理 dtw_getNextRow() 介面函數。

   • 如果沒有，則一次一列的處理程序結束， 而 Net.Data 會繼續處理 Net.Data 巨集。

呼叫 dtw_getNextRow() 後，會設定 dtw_lei_t 結構中的橫列欄位以指向橫列物件。 欲處理橫列物件，請使用 Net.Data 公用程式函數 dtw_row_SetCols() 及 dtw_row_SetV()。 Net.Data 會假設在第一次呼叫 dtw_getNextRow() 介面函數後， 橫列物件會包含該表格的直欄標題。 後續的呼叫包含實際的表格資料。

只要有設定 DTW_LE_CONTINUE 旗號，就會繼續呼叫 dtw_getNextRow() 函數 （除非訊息區塊處理有另外指示）。