呼叫離線後，將 LU0 會話設回線上狀態。
語法
void Online(
short initType,
ref System.Array data,
int timeout)
參數
| 參數 | 說明 |
|---|---|
initType |
描述會話啟動類型。 如需詳細資訊，請參閱一節。 |
data |
如有需要，包含 INITSELF 或 SSCP 登入訊息。 |
timeout |
等待 BIND 和 SDT 到達的時間，也就是毫秒。 如果逾時在 SDT 到達前就到期，SNA 伺服器 LU 會被釋放並回傳錯誤。 0xffffffff表示無限時間。 |
傳回值
| 價值 | 說明 |
|---|---|
| S_OK | LU0 會話已成功重新啟動，LU 會話已啟動並準備接收輸入。 |
| CLU0_S_SSCP_ACTIVE | LU0 會話已成功重新啟動，SSCP 會話已啟用並準備接收輸入。 只有在 initType 設定為 INIT_SSCP 時才有效。 |
| CLU0_E_NEG_RESPONSE | 主機或 SNA 伺服器對 INITSELF 或未格式化的登入指令發出負面回應。 僅 initType 在 設定為 INIT_INITSELF 或 INIT_LOGON 時有效 |
| CLU0_E_BADPARAM |
connectionStr 包含一個無效的屬性設定。 |
| CLU0_E_NOFREELU |
luname 指定一個 SNA 伺服器 LU 池，且該池中沒有空閒的 LU。 |
| CLU0_E_LUINUSE |
luname 指定了一個 SNA 伺服器 LU，而該 LU 目前正被其他應用程式使用。 |
| CLU0_E_LUNOTFOUND | 沒有 LU 或 pool 名稱。 |
| CLU0_E_TIMEDOUT | 該場次未在指定的暫停時間內開始。 |
| CLU0_E_SESSION_FAILED | 底層的 SNA 會話失敗，可能是因為連結中斷或其他暫時性故障。 你必須斷開連線並釋放伺服器會話。 你可以選擇性地呼叫 Icom3270.Offline 重設伺服器，然後再用呼叫 Icom3270.Online 重新啟動會話。 |
| CLU0_E_SERVER_FAILURE | TSS 會話已不再有效。 你應該解除 session handle 。 |
| CLU_E_WAITING | 另一個執行緒已對此方法發出 Receive 呼叫，但尚未回傳。 |
| CLU_E_SYSERROR | 此方法因內部錯誤而失敗。 |
例外狀況
備註
線上會嘗試取得與該會話上次上線時相同的 SNA 伺服器 LU，也就是同一台 SNA 伺服器。
下表描述的 initType可能值。
| 名稱 | 價值 | 說明 |
|---|---|---|
| INIT_BIND | 0 | 等待PLU主動提出的BIND和SDT。 |
| INIT_SSCP | 1 | 等待 BIND 和 SDT 抵達，但允許應用程式存取 SSCP 會話，以便傳送 SSCP 資料與指令。 |
| INIT_INITSELF | 2 | 在發送 INITSELF 指令 data後，等待 BIND 和 SDT 送達。 |
| INIT_LOGON | 3 | 在發送指定為未格式化的 SSCP 登入訊息 data後，等待 BIND 和 SDT 送達。 |