4.3.1 dc_rpc_open_sUAPの開始

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

(1) 形式

(a) _s付き関数の場合

#include <dcvrpc.h>
DCLONG dc_rpc_open_s(DCCLT_ID cltid, DCLONG flags)

(b) _s無し関数の場合

#include <dcvrpc.h>
int dc_rpc_open(DCLONG flags)

(2) 機能

OpenTP1のSPPを呼び出すための環境,またはTCP/IP通信機能を使用するための環境を初期化します。

dc_rpc_open_s関数は,RPC,トランザクション制御,トランザクション制御の各種関数を実行する前に実行してください。

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

(4) リターン値

リターン値数値
(10進数)
意味
DC_OK0正常終了しました。
DCRPCER_INVALID_ARGS-2401引数に指定した値が誤っています。
DCRPCER_PROTO-2402dc_rpc_open_s関数はすでに実行されています。
または,dc_clt_cltin_s関数が実行されていません。
DCRPCER_FATAL-2403次のどれかの要因で,このリターン値が戻りました。
・初期化に失敗しました。
・クライアント環境定義の指定が誤っています。
DCRPCER_PORT_IN_USE-2447指定したポート番号は使用されています。
DCCLTER_INVALID_CLTID-2544cltidに指定したクライアントIDは,dc_clt_cltin_s関数で受け取ったクライアントIDと異なっています。

(5) 注意事項

次に示す場合は,dc_rpc_close_s関数を実行した直後に,再びflagsにDCCLT_ONEWAY_RCVを指定したdc_rpc_open_s関数は実行できません。この場合,15秒から20秒後にdc_rpc_open_s関数を実行してください。