kv_open_store()

#include <kvstore.h>

kv_error_t 
kv_open_store(const kv_impl_t *impl,
              kv_store_t **store,
              kv_config_t *config)

KVストア・ハンドル(構造)をオープンします。kv_close_store()を呼び出して、この構造に割り当てられたリソースを解放します。

成功時にはconfigパラメータが提供されるため、アプリケーションは成功時にkv_config_t構造を無視する必要があります。この関数が失敗した場合は、kv_release_config()を呼び出す必要があります(これは、ストア・オープン時にエラーが発生し、構成構造を明示的に解放する必要がある場合のみです)。失敗時には、kv_get_open_error()を使用してエラー情報を取得できる場合があります。

この関数はスレッドセーフではないため、同じkv_impl_tインスタンスで同時に呼び出すことはできません。

パラメータ

  • impl

    implパラメータは、ライブラリに使用している実装構造です。これは、kv_create_jni_impl()を使用して作成されます。

  • store

    storeパラメータは、割り当てられたストア・ハンドル(構造)へのポインタのコピー先であるメモリーを参照します。

  • config

    configパラメータは、このハンドルを構成するために使用する構成構造です。これは、kv_create_config()を使用して作成されます。