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

[目次][索引][前へ][次へ]

dc_adm_get_nodeconf_next

名称

ノード識別子の取得

形式

ANSI C ,C++の形式

 
#include <dcadm.h>
int  dc_adm_get_nodeconf_next(char *node_id,DCLONG flags)
 

K&R版 C の形式

 
#include <dcadm.h>
int  dc_adm_get_nodeconf_next(node_id,flags)
char       *node_id;
DCLONG     flags;
 

機能

この関数を呼び出したユーザサーバが属するマルチノードエリアのすべてのノード,またはマルチノードサブエリアにあるノード識別子を,1件取得します。

取得するデータは,dc_adm_get_nodeconf_begin関数を呼び出したタイミングで取得したデータです。

UAPで値を設定する引数

●node_id

ノード識別子を受け取る領域へのポインタを設定します。ノード識別子の最後にはヌル文字を設定します。この領域には,DCADM_NODE_ID_SIZEで定義している長さが必要です。

●flags

DCNOFLAGSを設定します。

リターン値

リターン値 リターン値(数値) 意味
DC_OK 0 正常に終了しました。
DCADMER_PARAM -1852 引数に設定した値が間違っています。
DCADMER_PROTO -1854 dc_adm_get_nodeconf_begin関数を呼び出していません。
dc_rpc_open関数を呼び出していません。
DCADMER_MULTI_DEF -1864 システム共通定義のmulti_node_optionオペランドにNを指定しています。
システムにTP1/Multiが組み込まれていません。
システムに正しいバージョンのTP1/Multiが組み込まれていません。
DCADMER_NO_MORE_ENTRY -1865 OpenTP1ノードは,これ以上ありません。すべてのノード識別子の取得を終了しました。