IcomLUO.Receive メソッド

LU0 セッションで送信データを受信します。

構文

  
void Receive(  
   int timeout,  
   ref int datasize,  
   out int indication,  
   out short seqno,  
   ref System.Array data  
)  

パラメーター

値	説明
timeout	スレッドがデータの到着を待機できる時間 (ミリ秒単位)。 を設定 dataSizeすると、タイムアウト後にアプリケーションが部分的なデータを受け入れるかどうかを指定できます。 0xffffffff を に howLong 入力すると、無限の時間が示されます。
datasize	アプリケーションが受け入れるデータの最大量。 タイムアウトが競合する前にデータのバイト数を受信した場合 dataSize 、Receive は部分チェーンを返します。 このメソッドから制御が戻るときに、データ バッファーに存在するバイト数が格納されます。
indication	ビットごとの OR に、送信データストリームに関する追加情報を含む 1 つ以上のフラグ。 詳細については、「解説」を参照してください。
seqno	このメソッドが戻るときに、チェーンの SNA シーケンス番号を格納します。 NEG_RESPONSEが にindicationseqno設定されている場合は、代わりにホストが応答を送信したチェーンのシーケンス番号を含む可能性があります。 で seqno 返される値は、SNA 応答を送信するために IcomLU0.SendResponse で使用できます。
data	受信するデータを含む配列。

戻り値

値	説明
S_OK	データの完全なチェーン、またはその他の部分の残りの部分がデータ バッファーに受信されました。
CLU0_S_PARTIAL_CHAIN	データの部分的なチェーンがデータ バッファーに受信されました。
CLU0_S_TIMEOUT	指定されたタイムアウト内にデータが受信されませんでした。 別の Receive を発行する必要があります。
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 データの完全なチェーンが使用可能になるまで受信ブロックします。 ただし、アプリケーションは、、maxData、および incompleteDataを使用してブロックをhowLong制御できます。

Receive は、アプリケーション レベルのデータのみを返します。 具体的には、Receive は SNA TH ヘッダーと RH ヘッダーを返しません。

次の表では、 で使用できる値について説明します indication。

値	説明
SESSION_STARTED	次のいずれか: - SSCP によって開始されたセッションがアクティブ化されました。 - CLEAR によってリセットされたセッションが SDT によって再起動されました。 - UNBIUND を以前に受け取ったセッションが BIND と SDT によって再アクティブ化されました。
BEGIN_BRACKET	ホストが新しいブラケットを開始しました。
END_BRACKET	ホストは現在のブラケットを終了しました。
SEND	ホストに送信するアクセス許可が付与されています。
DATA_COMPLETE	データは、完全なデータ チェーンまたはデータ チェーンの末尾を表します。
DATA_INCOMPLETE	データは不完全なデータ チェーンを表します。
CANCEL	ホストからの最後のチェーンが取り消されました。
NO_RESPONSE	アプリケーションがデータに応答を送信しないようにする必要があります。
EXCEPTION_RESPONSE1/2	アプリケーションは、データを拒否するために否定的な応答を送信するか、または提供の確認を送信する場合があります。
DEFINITE_RESPONSE1/2	アプリケーションは、データへの応答を送信する必要があります。
POS_RESPONSE	ホストから肯定的な応答が送信されました。
NEG_RESPONSE	ホストから否定的な応答が送信されました。
EXR_REQUEST	SNA サーバーは、ホスト要求を例外要求に変換しました。
CHASE	ホストは、未処理のすべての応答を送信することを要求します。
NORMAL_DATA	データは通常のデータ フローで受信されました。
EXPEDITED_DATA	データは、優先データ フローで受信されました。
APPL_DATA	データはアプリケーション (FMD) データです。
FM_DATA	データは関数管理 (FMH) データです。
LU_DATA	データは LU セッションで受信されました。
SSCP_DATA	データは SSCP セッションで受信されました。
CLEAR	ホストがセッションをクリアしました。
休止	ホストがセッションを休止しました。
SHUTDOWN	ホストがセッションをシャットダウンしています。
RELEASE	ホストは休止状態またはシャットダウン状態を取り消しました。
アンバインド	ホストは LU-LU セッションのバインドを解除します。

参照

IcomLU0 メソッド
LU0 のセッション インテグレーター