ee_mcp_cninfo - コネクション情報の取得
- 〈このページの構成〉
機能
コネクション情報を取得します。
形式
- ANSI C,C++の形式
#include <eemcp.h> int ee_mcp_cninfo(EELONG action, char *idname, EEMCPCONIDINF *info, int flags)
UAPで値を設定する引数
●action
情報を取得するコネクションの指定方法を次の形式で設定します。
{EEMCPLE|EEMCPCN}
- EEMCPLE
-
情報を取得するコネクションを論理端末名称で指定するときに設定します。
- EEMCPCN
-
情報を取得するコネクションをコネクションIDで指定するときに設定します。
●idname
情報を取得するコネクションの論理端末名称,またはコネクションIDを設定します。論理端末名称,またはコネクションIDは8バイト以内で設定し,文字列の最後にNULL文字を付けます。
●info
コネクション状態を格納する領域ee_mcp_conid_infを設定します。
●flags
EENOFLAGSを設定します。
MCPから値が返される引数
●info
この関数の対象となったコネクションの情報が,構造体ee_mcp_conid_infで返されます。ただし,コネクション情報が設定されるのはリターン値がEE_OKの場合だけです。
構造体の形式を次に示します。
typedef struct ee_mcp_conid_inf {
char con_id[9];
char resv01[1];
unsigned short id_len;
char pname[4];
unsigned char r_ipaddr[16];
unsigned char o_ipaddr[16];
unsigned short r_port;
unsigned short o_port;
char resv02[4];
}EEMCPCONIDINF;●con_id
要求したコネクションのコネクションIDが設定されます。
●resv01
領域をNULL文字で埋めます。
●id_len
要求したコネクションのコネクションIDの文字列長が設定されます。
●pname
要求したコネクションのプロトコル種別が文字列で設定されます。
- ''TCP''
-
TCP/IPプロトコル
●r_ipaddr
相手システムのIPアドレスを設定します。
o_hostを設定した場合はo_ipaddrの設定は不要です。o_host,o_ipaddr共に設定した場合はo_ipaddr設定値が有効になります。
IPアドレスを設定する場合は,xxx.xxx.xxx.xxxの形式で設定します。xxxは,0〜255(10進数)で設定してください。ただし,0.0.0.0,255.255.255.255の設定は不可とします。
IPアドレスはo_ipaddrの下位4バイトに次の形式で設定します。
●o_ipaddr
相手システムのIPアドレスを設定します。
IPアドレスの設定形式に関してはr_ipaddrを参照してください。
●r_port
相手システムのポート番号を設定します。
ポート番号はホストバイトオーダー形式の数値で設定してください。数値は,1〜65535の符号なし整数で設定してください。
●o_port
相手システムのポート番号を設定します。
ポート番号の設定形式に関してはr_portを参照してください。
●resv02
領域をNULL文字で埋めます。
リターン値
|
リターン値 |
意味 |
|---|---|
|
EE_OK |
正常に受け付けました。 |
|
EECOMER_ENVIRON |
TP1/EE環境下にありません。 |
|
EECOMER_CNDUOC |
UOCから発行しているため,この機能は使用できません。 |
|
EEMCPER_ACTION |
actionに設定した値が間違っています。 |
|
EEMCPER_IDNAME |
idnameに設定した値が間違っています。 |
|
EEMCPER_OPTION |
flagsに設定した値が間違っています。 |
|
EEMCPER_ACT_BEGIN |
指定したコネクションが確立処理中状態です。 |
|
EEMCPER_DCT |
指定したコネクションが未確立状態です。 |
|
EEMCPER_DCT_BEGIN |
指定したコネクションが解放処理中状態です。 |
|
EEMCPER_INFO |
infoに設定した値が間違っています。 |