Icom3270.wait 方法

Wait 方法會等候會話進入允許輸入或修改畫面的狀態。

語法

  
void Wait(  
   uint howLong,  
   int waitForUpdate  
)  

參數

參數
howLong 一段時間(以0.5 秒為單位),表示執行緒願意 waif 要啟用的輸入或要更新的畫面。 0xffffffff 表示執行緒應該無限期等候。
waitForUpdate 如果為 false,當會話處於允許的輸入狀態時,這個方法就會傳回。

如果會話目前處於允許的輸入狀態,會話就會立即傳回。

如需詳細資訊,請參閱<備註>一節。

傳回值

描述
S_OK 會話可供輸入。
C3270_S_SIZECHANGED 會話可供輸入,但在等候的叫用期間,會修改螢幕大小。 您應該 gall getScreenSize 來判斷新的螢幕大小。
C3270_E_SESSIONBUSY 3270會話仍在忙碌中,但 howLong 所指定的超時時間已過期。

您應該先執行任何必要的處理,然後再呼叫 wait。
C3270_E_SESSSIONLOCKED 3270會話因為本機鎖定條件而遭到鎖定。

您應該檢查 OIA 緩衝區以判斷錯誤的原因。 您也可以傳送重設按鍵來解除鎖定鍵盤,然後再次呼叫等候或執行任何其他的復原動作。
C3270_E_SESSIONFAILURE 3270會話失敗。 在等候進行期間,PLU_SLU 或 SSCP 會話已停用。

您應該檢查會話的 OIA 中的會話狀態,並採取適當的復原動作。
C3270_E_SYSERROR 因為發生內部錯誤,所以方法失敗。

備註

呼叫 wait 可讓會話在應用程式作用中、連接到主機,以及等候資料時,處理來自主機的訊息。

當主機解除鎖定鍵盤,並在個別作業中傳送螢幕更新時,您應該將 waitForUpdate 設定為 true。 尤其是,您應該在 SSCP 會話上進行這項作業,其中的輸入會在收到來自用戶端的 SNA 回應時啟用。 回復資料會繼續引來大量在後續的訊息中。