4.4.4 dc_clt_get_raphost_s − 常設コネクション確立要求先の取得
(1) 形式
(a) TP1/Client/Wの場合
■ _s付き関数
#include <dcvclt.h> DCLONG dc_clt_get_raphost_s(DCCLT_ID cltid, char *raphost, DCLONG flags)
■ _s無し関数
#include <dcvclt.h> DCLONG dc_clt_get_raphost(char *raphost, DCLONG flags)
(b) TP1/Client/Pの場合
■ _s付き関数
#include <dcvclt.h> DCLONG dc_clt_get_raphost_s(DCCLT_ID cltid, char CLTFAR *raphost, DCLONG flags)
■ _s無し関数
#include <dcvclt.h> DCLONG dc_clt_get_raphost(char CLTFAR *raphost, DCLONG flags)
(2) 機能
常設コネクション確立要求先のホスト名およびポート番号を取得します。この関数は,dc_clt_set_raphost_s関数で常設コネクション確立要求先を変更する前に,元の値を退避するために使用します。
この関数は,dc_clt_set_raphost_s関数で変更した常設コネクション確立要求先をraphostに返します。変更していない場合は,クライアント環境定義DCCLTRAPHOSTの値をraphostに返します。
(3) UAPで値を設定する引数
-
cltid
dc_clt_cltin_s関数で受け取ったクライアントIDを指定します。
-
raphost
現在設定されている常設コネクション確立要求先のホスト名およびポート番号を格納する256バイト※以上の領域へのポインタを指定します。
- 注※
-
クライアント環境定義DCCLTOPTIONに00000008を指定した場合,256バイトではなく,1024バイトになります。
-
flags
DCNOFLAGSを指定します。
(4) 値が返される引数
-
raphost
現在設定されている常設コネクション確立要求先のホスト名およびポート番号が返されます。クライアント環境定義DCCLTRAPHOSTを定義しないで,かつdc_clt_set_raphost_s関数で常設コネクション確立要求先を指定していない場合は,raphostの先頭にNULL文字が返されます。
- 形式
-
ホスト名〔:ポート番号〕〔,ホスト名〔:ポート番号〕,…〕
・ホスト名 〜〈文字列〉
・ポート番号 〜〈符号なし整数〉((5001〜65535))
(5) リターン値
リターン値 |
数値 (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と異なっています。 |
(6) 注意事項
引数raphostには,256バイト※以上の領域を指定してください。領域が256バイト※未満の場合,TP1/Client内部の処理で領域破壊を起こすおそれがあります。
- 注※
-
クライアント環境定義DCCLTOPTIONに00000008を指定した場合,256バイトではなく,1024バイトになります。