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

(1)　形式

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

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

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

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

ページの先頭へ

(6)　注意事項

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

注※

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

ページの先頭へ