20.1.29　ead_get_node_next_key()（EADSサーバ指定による次のkeyの取得）

(1)　機能

指定したEADSサーバに格納されているkeyのうち，ASCIIコードの昇順で，指定したkeyの次に位置するkeyを取得します。

なお，接続先のEADSサーバに存在しないkeyを指定した場合も同様に，指定したkeyの次に位置するkeyを取得します。

ページの先頭へ

(2)　形式

#include <eads.h>
char* ead_get_node_next_key
(
  const EAD_CACHE     *cp,             /* In */
  const ead_node      *target_node,    /* In */ 
  const char          *key,            /* In */
  int                 *error_code      /* Out */
);

ページの先頭へ

(3)　引数

cp

keyを取得するキャッシュのハンドル（ポインタ）を指定します。

ead_start_cache()で取得したハンドルを指定してください。

target_node

取得先のEADSサーバ（ead_node構造体）を指すポインタを指定します。

EADSが提供するクライアントライブラリを使用して取得したead_node構造体のポインタだけ指定できます。それ以外のポインタを指定した場合の動作は保証しません。

ead_node構造体の形式と説明については，「20.1.54　ead_node構造体（EADSサーバ指定のユーザファンクションで使用するオブジェクト）」を参照してください。

指定したead_node構造体が格納するアドレス情報（IPアドレスおよびポート番号）が，EADSクライアントが保持するどのEADSサーバのアドレス情報とも一致しない場合，エラーとなります。

key

基準とするkeyを指定します。

指定できるデータについては，「15.2.2(1)　keyとして指定できるデータ」を参照してください。

error_code

エラーコード取得先のポインタを指定します。

エラーコードについては，「20.2　クライアントライブラリのエラーコード（C言語）」を参照してください。

ページの先頭へ

(4)　戻り値

指定したEADSサーバに格納されているkeyのうち，ASCIIコードの昇順で，指定したkeyの次に位置するkeyが返却されます。

次の場合，NULLが返却されます。

• 指定したkeyの次に位置するkeyが存在しない場合

• エラーによってkeyの取得に失敗した場合

ページの先頭へ

(5)　注意事項

• keyの取得に成功した場合（戻り値がNULLでない場合），メモリ領域は自動的に解放されないため，APで解放してください。詳細については，「19.1.1(10)　戻り値として返却されたメモリ領域を解放する」を参照してください。

• 接続先以外のEADSサーバの縮退，復旧，追加（スケールアウト処理），および位置の変更（リバランス処理）によって，指定したグループに属するkeyを格納するEADSサーバが変更される場合があります。

• EADSサーバ上でグループに対して排他処理をしないため，ead_get_node_first_key()またはead_get_node_next_key()の実行後，他プロセスからの操作によって，グループに属するkeyが挿入，または削除されることがあります。

ページの先頭へ