kv_lob_get_version()

#include <kvstore.h>

kv_error_t 
kv_lob_get_version(kv_lob_handle_t *handle,
                   kv_version_t **version);

レコードのバージョンを返します。バージョンはハンドルによって所有されているため、ハンドルから独立して解放できません。使用可能なバージョンがない場合は、KV_INVALID_ARGUMENTが返されます。

レコードのバージョンは、kv_lob_get_for_read()を使用してハンドルを作成すると、ただちに使用可能になります。kv_lob_get_for_write()を使用している場合、バージョンが使用可能になるのは、(kv_lob_put_from_file()を使用して)LOBがストアに書き込まれた後のみです。

パラメータ

  • handle

    handleパラメータは、レコードのバージョンの取得元であるLOBハンドルです。

  • version

    versionパラメータは、値のコピー先であるメモリーを参照します。kv_release_version()を使用して、この値によって使用されるリソースを解放します。