dc_mcf_ap_info_uoc
名称
UOCへのアプリケーション情報通知
形式
ANSI C,C++の形式
#include<dcmcf.h>
int dc_mcf_ap_info_uoc(DCLONG flags, char *apname,
struct DC_MCFAPINFO_UOC *apinfo)
K&R版 C の形式
#include<dcmcf.h>
int dc_mcf_ap_info_uoc(flags, apname, apinfo)
DCLONG flags;
char *apname;
struct DC_MCFAPINFO_UOC *apinfo;
機能
引数apnameで指定したアプリケーションの定義内容(アプリケーション属性定義)やアプリケーションの状態(dc_mcf_ap_info_uoc関数を呼び出した時点での状態)などの情報(アプリケーション情報)をapinfoで指定したstruct DC_MCFAPINFO_UOCに設定します。dc_mcf_ap_info_uoc関数が正常終了した場合だけ,アプリケーション情報は有効となります。
UOCが動作する通信サービスから起動できないユーザアプリケーション,またはシステムイベントを指定した場合は,不正なアプリケーションが指定されたと見なし,DCMCFRTN_72001でエラーリターンします。
dc_mcf_ap_info_uoc関数が使用できるUOCは,入力メッセージ編集UOC(アプリケーション名決定UOC)だけです。そのほかのUOCからは使用できません。そのほかのUOCから使用した場合,動作は保証しません。
UAPで値を設定する引数
●flags
DCNOFLAGSを設定します。
●apname
取得したいアプリケーション名を指定します。
●apinfo
アプリケーション情報を取得する領域DC_MCFAPINFO_UOCのアドレスを指定します。
OpenTP1から値が返される引数
●apinfo
アプリケーション情報が,構造体DC_MCFAPINFOで返されます。
構造体の形式は次のとおりです。
struct DC_MCFAPINFO_UOC {
char mcf_apinfo[4];
DCLONG mcf_resv00;
char mcf_ap_name[9];
char mcf_ap_mcfid[3];
char mcf_resv01[4];
DCLONG mcf_ap_stat;
DCLONG mcf_ap_type;
DCLONG mcf_ap_msgcnt;
char mcf_sg_name[32];
DCLONG mcf_sg_stat;
DCLONG mcf_sg_hold;
DCLONG mcf_sg_msgcnt;
char mcf_sv_name[32];
DCLONG mcf_sv_stat;
DCLONG mcf_ap_ntmetim;
DCLONG mcf_ap_tempsize;
DCLONG mcf_ap_max_msgcnt;
DCLONG mcf_ap_trnmode;
DCLONG mcf_ap_quekind;
char mcf_resv02[64];
};
リターン値
リターン値 | リターン値(数値) | 意味 |
---|---|---|
DCMCFRTN_00000 | 0 | 正常に終了しました。 |
DCMCFRTN_72000 | -13000 | MHPサービス以外から呼び出されました。 |
DCMCFRTN_72001 | -13001 | アプリケーション名の設定が不正です。 指定したアプリケーションの情報を取得できません。 |
DCMCFRTN_72016 | -13016 | パラメタに不正な値があります。 |
上記以外 | プログラムの破壊などによる,予期しないエラーが起こりました。 |
注意事項