(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)
 

常設コネクション確立要求先のホスト名およびポート番号を指定します。この関数を使用した場合，クライアント環境定義DCCLTRAPHOSTに定義したホスト名およびポート番号は無視され，以降のdc_clt_connect_s関数では，この関数で指定したホスト名およびポート番号が使用されます。

常設コネクション確立要求先のホスト名およびポート番号をこの関数の実行前に戻すときは，dc_clt_get_raphost_s関数で返された元の値を，この関数で再設定してください。

• cltid
  dc_clt_cltin_s関数で受け取ったクライアントIDを指定します。
  
• raphost
  常設コネクション確立要求先のホスト名およびポート番号を指定します。
  

  形式

  ホスト名:ポート番号〔,ホスト名:ポート番号,…〕

  ・ホスト名　〜〈文字列〉

  ・ポート番号　〜〈符号なし整数〉((5001〜65535))

  ホスト名として指定できる長さは，63文字^※までです。ホスト名を複数指定する場合，引数raphostに指定できる長さ（ポート番号なども含む）は，255文字^※までです。
  区切り文字','の後ろ以外は空白文字（スペースまたはタブ）を入れないでください。
  

  注※

  クライアント環境定義DCCLTOPTIONに00000008を指定した場合，ホスト名として指定できる長さは255文字，ホスト名を複数指定する場合に引数raphostに指定できる長さ（ポート番号なども含む）は1023文字までとなります。

• flags
  DCNOFLAGSを指定します。
  

リターン値	数値 (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と異なっています。

• この関数は，クライアント環境定義DCCLTRAPHOSTに指定した値を変更しません。
• raphostにNULL文字へのポインタを指定した場合，DCCLTRAPHOSTが未定義の状態になります。この場合，以降のdc_clt_connect_s関数では，CUP実行プロセスまたはDCCM3の論理端末に常設コネクションを確立します。