kv_open_store_login()

#include <kvstore.h>

kv_error_t 
kv_open_store_login(const kv_impl_t *impl,
              kv_store_t **store,
              kv_config_t *config,
              kv_credentials_t *creds) 

KVストア・ハンドル(構造)をオープンし、提供された認証資格証明を使用してストアに対して認証を行います。kv_close_store()を呼び出してストアからログアウトし、この構造に割り当てられたリソースを解放します。kv_store_logout()を使用してストアからログアウトすることもできます。

成功時には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()を使用して作成されます。

• creds

  credsパラメータは、ストアへのログインに使用する資格証明構造です。この構造は、kv_create_password_credentials()を使用して作成します。

関連項目

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