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

(1)　形式

#include <dcvclt.h>
DCLONG dc_clt_set_raphost_s(DCCLT_ID cltid,
                            char *raphost,
                            DCLONG flags)

#include <dcvclt.h>
DCLONG dc_clt_set_raphost(char *raphost, DCLONG flags)

#include <dcvclt.h>
DCLONG dc_clt_set_raphost_s(DCCLT_ID cltid,
                            char CLTFAR *raphost,
                            DCLONG flags)

#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)　リターン値

ページの先頭へ

(5)　注意事項

• この関数は，クライアント環境定義DCCLTRAPHOSTに指定した値を変更しません。

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

ページの先頭へ