4.2.1 dc_clt_cltin_sクライアントユーザの認証要求

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

(1) 形式

(a) TP1/Client/Wの場合
●_s付き関数

#include <dcvclt.h>
DCLONG dc_clt_cltin_s(HWND hWnd, DCCLT_ID *cltid,
                     char *defpath,
                     char *target_host,
                     char *logname,
                     char *passwd,
                     char *set_host, DCLONG flags)

●_s無し関数

#include <dcvclt.h>
int dc_clt_cltin(char *target_host,
                char *logname,
                char *passwd,
                char *set_host, DCLONG flags)

(b) TP1/Client/Pの場合
●_s付き関数

#include <dcvclt.h>
DCLONG dc_clt_cltin_s(HWND hWnd, DCCLT_ID CLTFAR *cltid,
                     char CLTFAR *defpath,
                     char CLTFAR *target_host,
                     char CLTFAR *logname,
                     char CLTFAR *passwd,
                     char CLTFAR *set_host, DCLONG flags)

●_s無し関数

#include <dcvclt.h>
int dc_clt_cltin(char CLTFAR *target_host,
                char CLTFAR *logname,
                char CLTFAR *passwd,
                char CLTFAR *set_host, DCLONG flags)

(2) 機能

指定された窓口となるTP1/Serverに対して,ログイン名で指定されたクライアントユーザの認証を要求します。

ユーザ認証を抑止する場合でも,dc_clt_cltin_s関数は必ず実行してください。

(3) UAPで値を設定する引数

(4) 値が返される引数

(5) リターン値

リターン値数値
(10進数)
意味
DC_OK0正常終了しました。
DCCLTER_INVALID_ARGS-2501引数が誤っています。
DCCLTER_PROTO-2502すでにdc_clt_cltin関数が実行されています。dc_clt_cltin_s関数実行時は,このリターン値は返りません。
DCCLTER_FATAL-2503通信路の初期化に失敗しました。または,クライアント環境定義の指定が誤っています。
DCCLTER_NO_BUFS-2504必要なバッファが確保できませんでした。または,リソース不足が発生しました。
DCCLTER_NET_DOWN-2506通信障害が発生しました。
DCCLTER_OLTF_NOT_UP-2515設定したサービスがあるノードのOpenTP1が起動されていません。
DCCLTER_SYSERR-2518システムエラーが発生しました。
DCCLTER_REJECT-2527指定されたログイン名が対象とするホストに登録されていないか,またはパスワードが一致しません。または,ユーザ認証機能をサポートしていないOpenTP1サーバである可能性があります。システム共通定義client_uid_checkの指定が正しいか見直してください。
DCCLTER_PORT_IN_USE-2547指定したポート番号は使用されています。または,OSが自動的に割り当てるポート番号が不足しています。

(6) 注意事項