dc_rap_connect
名称
rapリスナーとのコネクションの確立
形式
ANSI C,C++の形式
#include <dcrap.h>
int dc_rap_connect(char *target_host, DCLONG target_port,
DCRAP_SV_ID *sv_id, DCLONG rflags)
K&R版 C の形式
#include <dcrap.h>
int dc_rap_connect(target_host, target_port, sv_id, rflags)
char *target_host;
DCLONG target_port;
DCRAP_SV_ID *sv_id;
DCLONG rflags;
機能
rapリスナーとrapクライアントとの間にコネクションを確立します。
コネクションを確立するrapリスナーはtarget_host上にtarget_portで起動されているrapリスナーです。
UAPで値を設定する引数
●target_host ~((1~255文字の英数字,ピリオド,およびハイフン))
rapリスナーが起動されているOpenTP1ノードのホスト名を設定します。
●target_port ~<符号なし整数>((1~65535))
rapリスナーの使用しているウェルノウンポートのポート番号を設定します。
●rflags
DCNOFLAGSを設定します。
OpenTP1から値が返される引数
●sv_id
正常終了,またはDCRAPER_ALREADY_CONNECTの場合,サービスIDが返されます。
リターン値
リターン値 | リターン値(数値) | 意味 |
---|---|---|
DC_OK | 0 | 正常終了しました。rapリスナーとのコネクションが確立されました。 |
DCRAPER_PARAM | -5501 | 引数が間違っています。 |
DCRAPER_PROTO | -5502 | プロトコル不正です。要因としては次のことが考えられます。
|
DCRAPER_NOMEMORY | -5503 | メモリ不足が発生しました。 |
DCRAPER_NETDOWN | -5505 | rapリスナーとの通信でネットワーク障害が発生しました。 |
DCRAPER_TIMEDOUT | -5506 | rapリスナーとの通信でタイムアウトが発生しました。 |
DCRAPER_NOSOCKET | -5507 | ソケット不足が発生しました。 |
DCRAPER_NOHOSTNAME | -5508 | ホスト名称が解決できません。 |
DCRAPER_MAX_CONNECTION | -5517 | 一つのプロセスからdc_rap_connect関数を呼び出せる上限値を超えました。 |
DCRAPER_NOMEMORY_SV | -5520 | rapリスナーまたはrapサーバでメモリ不足が発生しました。 |
DCRAPER_SHUTDOWN | -5521 | rapリスナーは停止中です。 |
DCRAPER_NOCONTINUE | -5522 | 続行できない障害が発生しました。障害の要因として次のことが考えられます。
|
DCRAPER_SYSCALL | -5523 | システムコールで予期しないエラーが発生しました。 |
DCRAPER_NOSERVICE | -5528 | rapリスナーは開始処理中,または停止処理中です。 |
DCRAPER_ALREADY_CONNECT | -5529 | すでにrapリスナーとのコネクションは確立しています。 |
DCRAPER_UNKNOWN_NODE | -5531 | 接続されていないネットワーク上のrapリスナーに対してコネクションを確立しようとしています。 |
DCRAPER_TIMEOUT_SV | -5532 | rapリスナーサービス定義のrap_watch_timeオペランドに指定したメッセージ送受信監視時間内にコネクションが確立できませんでした。 |
DCRAPER_PANIC_SV | -5533 | rapリスナーでシステム障害が発生しました。 |
DCRAPER_MAX_CONNECTION_SV | -5534 | rapリスナーの管理するrapクライアントとのコネクション要求受付可能最大数を超えました。 |
注意事項
DCRAPER_ALREADY_CONNECT以外のリターン値で,dc_rap_connect関数がエラーリターンした場合,rapリスナーとのコネクションは確立されていません。
UAPトレースに取得されるエラー要因コードは次のとおりです。