4.2.4.2 Receiveメソッド

Linkexpress 利用者プログラム開発ガイド

目次索引

Receiveメソッドは、ファイル受信を行います。

要求の受付結果は、CategoryCode(エラー分類コード)、DetailCode(詳細エラーコード)、DiagType(エラー診断タイプ)およびErrorCode(エラー原因コード)プロパティで通知されます。

TRUE : 正常完了。

FALSE : 異常完了。プロパティにエラー詳細が設定されます。

Receiveメソッドを呼び出してからCompleteイベント受け付けまでの間、要求発行用コントロールのプロパティの変更はできません。
Receiveメソッドを呼び出す際は、Initializeメソッドが呼び出されている必要があり、制御用コントロールのControlIdプロパティの値を要求発行用コントロールのControlIdプロパティに設定しておく必要があります。
当機能は突き放し型(注)です。復帰情報として、Receiveメソッドの受付結果がプロパティに設定されます。ファイル転送の完了は、Completeイベントで通知されます。また、コネクションは転送完了時に切断されます。
プロパティ設定時にコントロールでパラメタエラーを検出した時は、スロー(例外)通知を行います。メソッド呼び出し時のパラメタ異常を検出した時は、メソッドから異常復帰します。どちらの場合にも、プロパティにエラー詳細が設定されます。
Receiveメソッドの呼び出しには、TransferIdプロパティの値を0クリアする必要があります。
受信ファイルと同名の既存ファイルがあり、かつ、ファイル受信中に何らかのエラーが発生した場合、既存ファイルのデータ保証はできません。あらかじめ受信ファイルの内容を退避することをお勧めします。

注) 突き放し型：
ファイル転送の受け付けだけ行い、メソッド(サービス)が復帰します。メソッドの実行結果は転送処理の受け付け結果を示します。

目次索引