kv_create_config()

#include <kvstore.h>

kv_error_t 
kv_create_config(kv_config_t **config,
                 const char *store_name,
                 const char *host,
                 int port) 

kv_open_store()で使用する構成構造を作成します。この構造によって使用されるリソースは、kv_release_config()を使用して解放しますが、解放するのは、kv_open_store()が呼び出されたとき、またはこの関数がエラーを返したときにアプリケーションでエラーが発生した場合のみです。

hostおよびportパラメータを使用して、この関数をコールするときにヘルパー・ホストを少なくとも1つ識別する必要があることに注意してください。ヘルパー・ホストは、ストア内の他のノードを特定するためにアプリケーションによって使用されます。追加のヘルパー・ホストは、kv_config_add_host_port()を使用して識別できます。

この関数は、デフォルトのクライアント動作を定義します。この関数を使用して構成できるデフォルトはすべて、このAPIのPUT/GET/削除関数の適切なパラメータを使用して、操作単位でオーバーライドできます。

デフォルトのストア動作は、ストア・ハンドルを開く前にのみ定義できます。オープン時間後にこれらの構成オプションを変更しても、ストアの動作には影響しません。

パラメータ

• config

  configパラメータは、割り当てられた構成構造へのポインタのコピー先であるメモリーを参照します。

• store_name

  store_nameパラメータは、KVストアの名前です。ストア名は、間違ったホストまたはポートが誤って使用されるのを防ぐために使用されます。ストア名は、すべて大文字または小文字と数字で構成する必要があります。

• host

  hostパラメータは、ストアに属するノードのネットワーク名です。ノードは現在アクティブである必要があります。これは、アプリケーションがストア内の他のノードを特定するためのヘルパー・ホストとして使用されるためです。

• port

  portパラメータは、ヘルパー・ホストのポート番号です。

関連項目

• ストアおよびライブラリの操作