LU0 セッションで送信データを受信します。
構文
void Receive(
int timeout,
ref int datasize,
out int indication,
out short seqno,
ref System.Array data
)
パラメーター
| 価値 | 説明 |
|---|---|
timeout |
スレッドがデータの到着を待機できる時間 (ミリ秒単位)。dataSize設定すると、タイムアウト後にアプリケーションが部分的なデータを受け入れるかどうかを指定できます。howLongに0xffffffffを入力すると、時間の長さが無限であることを示します。 |
datasize |
アプリケーションが受け入れるデータの最大量。 タイムアウトが競合する前に dataSize バイトのデータを受信すると、Receive は部分チェーンを返します。このメソッドから制御が戻るときに、データ バッファーに存在するバイト数が格納されます。 |
indication |
送信データストリームに関する追加情報を含むビットごとの OR の 1 つ以上のフラグ。 詳細については、「解説」セクションを参照してください。 |
seqno |
このメソッドが戻るときに、チェーンの SNA シーケンス番号を格納します。 NEG_RESPONSEが indication で設定されている場合、ホストが応答を送信したチェーンのシーケンス番号が seqno に含まれる場合があります。seqnoで返される値は、SNA 応答を送信するために IcomLU0.SendResponse で使用できます。 |
data |
受信するデータを含む配列。 |
戻り値
| 価値 | 説明 |
|---|---|
| S_OK | 完全なデータチェーン、または部分的なデータチェーンの残りの部分がデータ バッファーに受信されました。 |
| CLU0_S_PARTIAL_CHAIN | データ の部分的なチェーンがデータ バッファーに受信されました。 |
| CLU0_S_TIMEOUT | 指定されたタイムアウト時間内にデータが受信されませんでした。 別の受信を発行する必要があります。 |
| CLU0_E_SESSIONFAILURE | LU0 セッションが失敗しました。 |
| CLU0_E_SERVER_FAILURE | TSS セッションは無効です。 アプリケーションはセッション ハンドルを解放する必要があります。 |
| CLU0_E_WAITING | 別のスレッドがこのメソッドの Receive 呼び出しを発行し、まだ返されていません。 |
| CLU0_E_SESSION_FAILED | リンクの停止またはその他の一時的な障害が原因で、基になる SNA セッションが失敗しました。 サーバー セッションを切断して解放する必要があります。 または、IcomLU0.Offline を呼び出してセッションをリセットし、IcomLU0.Online を呼び出してセッションをリアクティブ化することもできます。 |
| CLU0_E_NOTCONNECTED | comLU0 クライアントは、Icom3270.Connect の呼び出しを介してセッションに接続されていません。 |
| CLU0_E_BADPARAM | いずれかのパラメーターに無効な値が含まれていました。 |
| CLU0_E_SYSERROR | 内部エラーのため、メソッドが失敗しました。 |
例外
注釈
通常、受信ブロックは、SNA データの完全なチェーンが使用可能になるまでブロックします。 ただし、アプリケーションは、 howLong、 maxData、および incompleteDataを使用してブロックを制御できます。
Receive は、アプリケーション レベルのデータのみを返します。 具体的には、Receive は SNA TH および RH ヘッダーを返しません。
次の表では、 indicationに使用できる値について説明します。
| 価値 | 説明 |
|---|---|
| SESSION_STARTED | 次のいずれか: - SSCP によって開始されたセッションがアクティブ化されました。 - CLEAR によってリセットされたセッションが SDT によって再起動されました。 - UNBIUND を以前に受信したセッションが BIND および SDT によって再アクティブ化されました。 |
| BEGIN_BRACKET | ホストが新しい角かっこを開始しました。 |
| END_BRACKET | ホストは現在のブラケットを終了しました。 |
| SEND | ホストに送信するアクセス許可が与えられている。 |
| DATA_COMPLETE | データは、完全なデータ チェーンまたはデータ チェーンの末尾を表します。 |
| DATA_INCOMPLETE | データは不完全なデータ チェーンを表します。 |
| キャンセル | ホストからの最後のチェーンが取り消されました。 |
| NO_RESPONSE | アプリケーションは、データに応答を送信しないでください。 |
| EXCEPTION_RESPONSE1/2 | アプリケーションは、データを拒否するために否定的な応答を送信したり、提供確認を送信したりする場合があります。 |
| DEFINITE_RESPONSE1/2 | アプリケーションは、データに応答を送信する必要があります。 |
| POS_RESPONSE | ホストが肯定的な応答を送信しました。 |
| NEG_RESPONSE | ホストが否定的な応答を送信しました。 |
| EXR_REQUEST | SNA サーバーは、ホスト要求を例外要求に変換しました。 |
| 追跡 | ホストは、未処理のすべての応答を送信することを要求します。 |
| NORMAL_DATA | データは通常のデータ フローで受信されました。 |
| EXPEDITED_DATA | データは、迅速なデータ フローで受信されました。 |
| APPL_DATA | データはアプリケーション (FMD) データです。 |
| FM_DATA | データは関数管理 (FMH) データです。 |
| LU_DATA | LU セッションでデータを受信しました。 |
| SSCP_DATA | データは SSCP セッションで受信されました。 |
| CLEAR | ホストがセッションをクリアしました。 |
| 休止 | ホストがセッションを休止しました。 |
| シャットダウン | ホストがセッションをシャットダウンしています。 |
| 解放 | ホストは休止状態またはシャットダウン状態を取り消しました。 |
| アンバインド | ホストは、LU-LU セッションのバインドを解除します。 |