4.4.3 dc_clt_set_raphost_s常設コネクション確立要求先の指定

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

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

(4) リターン値

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

(5) 注意事項