kv_store_login()

#include <kvstore.h>

kv_error_t 
kv_store_login(kv_store_t *store,
               kv_credentials_t *creds) 

ストア・ハンドルによって使用されるログイン資格証明を更新します。この関数は、次の2つの状況のいずれかで使用します。

  1. アプリケーションはKV_AUTH_FAILUREを返します。この関数を呼び出すと、ハンドルはストアに対する認証を再確立しようとします。この場合に使用される資格証明は、ハンドルの現在のログイン・ユーザー用である必要があります。

  2. kv_store_logout()への呼出しのためにハンドルが現在ログアウトしている場合は、この関数を使用してストアにログインできます。その場合、有効なユーザーのログイン資格証明を使用できます。

資格証明構造は、kv_create_password_credentials()を使用して作成します。

パラメータ

  • store

    storeパラメータは、認証または再認証に使用するストア・ハンドルを参照します。

  • creds

    credsパラメータは、このログイン試行に使用する認証資格証明の構造です。