アプリケーションの実行中に作成された内部データ値をオーバーライドできます。
制約事項: 本トピックは、Enterprise Server 機能が有効な場合にのみ該当します。
構文:
typedef cblt_rtncode (*PFI_IDP_EXIT)(mf_uns32 exit_point,
IDP_EXIT_INFO *exit_info);
入力パラメーター:
- exit_point
- 6 = 内部データ値の変更 - 出力パラメーター
- exit_info
-
version |
構造体形式のバージョン |
フラグ |
0 |
data_size |
data_ptr フィールドで指定されるデータのサイズ |
funcs |
ユーザー出口サポート関数 |
field_name |
COBOL プログラムの連絡節のデータ項目名 |
data_ptr |
field_name に関連付けられた内部データの値 |
ext_param_name |
外部パラメーター名 |
request_cxt |
要求コンテキスト |
exit_data |
ユーザー出口に固有のデータ |
出力パラメーター:
- exit_info
-
- exit_data
- ユーザー出口に固有のデータ
戻りコード:
- IDP_EXIT_CONTINUE
- 0 = デフォルトのパラメーター マッピングで継続します。
- IDP_EXIT_STOP
- 1 = マッピング処理を終了します。エラー応答が必要です。
- IDP_EXIT_HANDLED
- 出口処理は与えられた内部データの値を上書きしました。
説明:
この出口処理により、アプリケーション実行中に作成された内部データ値を上書きできます。data_ptr は、内部データ値に割り当てられたメモリを指します。出口処理がこのパラメーターを上書きすることを選択すると、data_ptr から data_size バイト分のみを変更し、IDP_EXIT_HANDLED を返す必要があります。要求ハンドラーは、元の内部データ値 (IDP_EXIT_CONTINUE) か、または上書きされた内部データ値 (IDP_EXIT_HANDLED) へのデフォルトのマッピングを実行します。
ユーザー出口プログラムは、IDP_EXIT_INFO 構造体の exit_data フィールドを所有します。通常、この情報を出口ポイントの起動間のコンテキスト情報を保持するために使用します。IDP_EXIT_ 戻り値を返す場合に、この情報を使用できます。