4.4.3 dc_clt_set_raphost_s − 常設コネクション確立要求先の指定
- 〈この項の構成〉
(1) 形式
(a) TP1/Client/Wの場合
■ _s付き関数
#include <dcvclt.h> DCLONG dc_clt_set_raphost_s(DCCLT_ID cltid, char *raphost, DCLONG flags)
■ _s無し関数
#include <dcvclt.h> DCLONG dc_clt_set_raphost(char *raphost, DCLONG flags)
(b) TP1/Client/Pの場合
■ _s付き関数
#include <dcvclt.h> DCLONG dc_clt_set_raphost_s(DCCLT_ID cltid, char CLTFAR *raphost, DCLONG flags)
■ _s無し関数
#include <dcvclt.h> DCLONG dc_clt_set_raphost(char CLTFAR *raphost, DCLONG flags)
(2) 機能
常設コネクション確立要求先のホスト名およびポート番号を指定します。この関数を使用した場合,クライアント環境定義DCCLTRAPHOSTに定義したホスト名およびポート番号は無視され,以降のdc_clt_connect_s関数では,この関数で指定したホスト名およびポート番号が使用されます。
常設コネクション確立要求先のホスト名およびポート番号をこの関数の実行前に戻すときは,dc_clt_get_raphost_s関数で返された元の値を,この関数で再設定してください。
(3) UAPで値を設定する引数
-
cltid
dc_clt_cltin_s関数で受け取ったクライアントIDを指定します。
-
raphost
常設コネクション確立要求先のホスト名およびポート番号を指定します。
- 形式
-
ホスト名:ポート番号〔,ホスト名:ポート番号,…〕
・ホスト名 〜〈文字列〉
・ポート番号 〜〈符号なし整数〉((5001〜65535))
ホスト名として指定できる長さは,63文字※までです。ホスト名を複数指定する場合,引数raphostに指定できる長さ(ポート番号なども含む)は,255文字※までです。
区切り文字','の後ろ以外は空白文字(スペースまたはタブ)を入れないでください。
- 注※
-
クライアント環境定義DCCLTOPTIONに00000008を指定した場合,ホスト名として指定できる長さは255文字,ホスト名を複数指定する場合に引数raphostに指定できる長さ(ポート番号なども含む)は1023文字までとなります。
-
flags
DCNOFLAGSを指定します。
(4) リターン値
リターン値 |
数値 (10進数) |
意味 |
---|---|---|
DC_OK |
0 |
正常終了しました。 |
DCCLTER_INVALID_ARGS |
-2501 |
引数に指定した値が誤っています。 |
DCCLTER_PROTO |
-2502 |
トランザクション内で発行されているか,常設コネクション確立中です。または,dc_rpc_open_s関数が発行されていません。 |
DCCLTER_NO_BUFS |
-2504 |
必要なバッファが確保できませんでした。 |
DCCLTER_INVALID_CLTID |
-2544 |
cltidに指定したクライアントIDは,dc_clt_cltin_s関数で受け取ったクライアントIDと異なっています。 |
(5) 注意事項
-
この関数は,クライアント環境定義DCCLTRAPHOSTに指定した値を変更しません。
-
raphostにNULL文字へのポインタを指定した場合,DCCLTRAPHOSTが未定義の状態になります。この場合,以降のdc_clt_connect_s関数では,CUP実行プロセスまたはDCCM3の論理端末に常設コネクションを確立します。