4.4.4 dc_clt_get_raphost_s常設コネクション確立要求先の取得

<この項の構成>
(1) 形式
(2) 機能
(3) UAPで値を設定する引数
(4) 値が返される引数
(5) リターン値
(6) 注意事項

(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で値を設定する引数

(4) 値が返される引数

(5) リターン値

リターン値数値
(10進数)
意味
DC_OK0正常終了しました。
DCCLTER_INVALID_ARGS-2501引数に指定した値が誤っています。
DCCLTER_PROTO-2502dc_rpc_open_s関数が発行されていません。
DCCLTER_NO_BUFS-2504必要なバッファが確保できませんでした。
DCCLTER_INVALID_CLTID-2544cltidに指定したクライアントIDは,dc_clt_cltin_s関数で受け取ったクライアントIDと異なっています。

(6) 注意事項

引数raphostには,256バイト以上の領域を指定してください。領域が256バイト未満の場合,TP1/Client内部の処理で領域破壊を起こすおそれがあります。

注※
クライアント環境定義DCCLTOPTIONに00000008を指定した場合,256バイトではなく,1024バイトになります。