22.1.17 ead_get_nodelist()(接続先EADsサーバの情報取得)
(1) 機能
EADsクライアントが保持している接続先EADsサーバの情報を取得します。
(2) 形式
#include <eads.h> ead_nodelist ead_get_nodelist ( const EAD_CACHE_MANAGER *cmp, /* In */ int *error_code /* Out */ );
(3) 引数
- cmp
-
キャッシュを管理するキャッシュマネージャのハンドル(ポインタ)を指定します。
ead_init_client()またはead_init_client_n()で取得したハンドルを指定してください。
- error_code
-
エラーコード取得先のポインタを指定します。
エラーコードについては,「22.2 クライアントライブラリのエラーコード(C言語)」を参照してください。
(4) 戻り値
EADsクライアントが保持している接続先EADsサーバの情報(ead_nodelist構造体)が返却されます。
ead_nodelist構造体の形式と説明については,「22.1.22 ead_nodelist構造体(EADsサーバ情報)」を参照してください。
異常終了時には,ead_nodelist構造体のnodesメンバにNULLが返却されます。
(5) 注意事項
-
戻り値として返却されたead_nodelist構造体のnodesメンバがNULLでない場合,メモリ領域は自動的に解放されないため,APで解放してください。
-
AP実行時にEADsサーバへの通信は行われません。そのため,返却された接続先EADsサーバの情報が最新でないことがあります。