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_000000正常に終了しました。
DCMCFRTN_72000-13000MHPサービス以外から呼び出されました。
DCMCFRTN_72001-13001アプリケーション名の設定が不正です。
指定したアプリケーションの情報を取得できません。
DCMCFRTN_72016-13016パラメタに不正な値があります。
上記以外プログラムの破壊などによる,予期しないエラーが起こりました。

注意事項

  1. dc_mcf_ap_info_uoc関数を使用できるUOCは入力メッセージ編集UOC(アプリケーション名決定UOC)だけです。dc_mcf_ap_info_uoc関数がそのほかのUOCで呼び出されたかどうかのチェックはできないので,そのほかのUOCでの動作は保証しません。UOCについては,マニュアル「OpenTP1 プロトコル」の該当するプロトコル編を参照してください。
  2. UOCへのアプリケーション情報通知関数で取得できるアプリケーションの情報は,UOCが動作する通信サービスから起動できるユーザアプリケーションだけです。また,システムイベント(MCFアプリケーション定義mcfaalcapの-nオプションのkindオペランドにmcfを指定した定義)に関するアプリケーション情報は通知しません。
  3. UAPトレースは取得されません。