kv_get_with_options()

#include <kvstore.h>

kv_error_t 
kv_get_with_options(kv_store_t *store,
                    const kv_key_t *key,
                    kv_value_t **valuep,
                    kv_consistency_t *consistency,
                    kv_timeout_t timeout_ms)

キーに関連付けられた値を取得します。この関数では、デフォルト以外の一貫性ポリシーとタイムアウト値を使用できます。

パラメータ

store

storeパラメータは、値の取得元であるストアへのハンドルです。
key

keyパラメータは、key/valueペアを参照するために使用するキーです。
valuep

valuepパラメータは、取得したレコードの値部分のコピー先となるメモリーを参照します。kv_release_value()を使用して、この構造によって使用されるリソースを解放します。
consistency

consistencyパラメータは、この操作で使用する一貫性ポリシーです。一貫性ポリシーは、kv_create_simple_consistency()、kv_create_time_consistency()またはkv_create_version_consistency()を使用して作成します。

NULLの場合、ストアのデフォルトの一貫性ポリシーが使用されます。
timeout_ms

timeout_msパラメータは、GET操作を処理する際の時間間隔の上限をミリ秒単位で識別します。指定された限度を超えないよう最善が尽くされます。ゼロの場合は、デフォルトの要求タイムアウトが使用されます。