Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス C言語編


dc_rpc_get_gateway_address

〈このページの構成〉

名称

ゲートウェイのノードアドレスの取得

形式

ANSI C,C++の形式

 #include <dcrpc.h>
 int dc_rpc_get_gateway_address(DCULONG *node,DCLONG flags)

K&R版 C の形式

 #include <dcrpc.h>
 int dc_rpc_get_gateway_address(node, flags)
 DCULONG    *node;
 DCLONG     flags;

機能

アプリケーションゲートウェイ型ファイアウォールなどの,ゲートウェイを介してクライアントUAPからのサービス要求を受信したとき,サーバUAPでゲートウェイのノードアドレスを取得します。

リモートAPI機能を使用してサービスを要求した場合,サーバUAPで,ゲートウェイのノードアドレスを取得できます。

dc_rpc_get_gateway_address関数で返されたアドレスを使って,サービスの応答やエラーの応答などの送信はできません。

dc_rpc_get_gateway_address関数は,サービス関数から呼び出してください。サービス関数以外から呼び出した場合の処理は保証しません。

UAPで値を設定する引数

●node

ゲートウェイのノードアドレスが返される領域のアドレスを設定します。

●flags

DCNOFLAGSを設定します。

OpenTP1から値が返される引数

●node

ゲートウェイのノードアドレスが返されます。

リモートAPI機能を使用していない場合には0が設定されます。

リターン値

リターン値

リターン値(数値)

意味

DC_OK

0

正常に終了しました。

DCRPCER_INVALID_ARGS

-301

引数に設定した値が間違っています。

DCRPCER_PROTO

-302

サービス関数から呼び出されていません。