kv_create_delete_with_options_op()

#include <kvstore.h>

kv_error_tkv_create_delete_with_options_op(kv_operations_t *list,
                      const kv_key_t *key,
                      const kv_version_t *version,kv_return_value_version_enum return_info,
                      kv_int_t abort_on_failure) 

kv_execute()を使用して実行する複数ステップ操作の一部としての使用に適した複雑な削除操作を作成します。実行時に返される操作のセマンティクスは、kv_delete_with_options()のものと同じです。

パラメータ

  • list

    listパラメータは、この削除操作が追加される操作シーケンスです。シーケンスは、kv_create_operations()を使用して割り当てられます。

  • key

    keyパラメータは、削除されるレコードのキー部分を識別します。

    kv_execute()への1回のコールで実行されるすべての操作が同じメジャー・キー・パスを共有する必要があること、およびそのメジャー・キー・パスが完了する必要があることに注意してください。

  • version

    versionパラメータは、レコードを削除する前にそのレコードが一致している必要があるバージョンを示します。バージョンは、kv_get_version()関数を使用して取得されます。

  • return_info

    return_infoパラメータは、この操作によってkv_execute() 結果リストに返される必要がある情報を指定します。このパラメータによって受け入れられるオプションの詳細は、kv_return_value_version_enumを参照してください。

  • abort_on_failure

    abort_on_failureパラメータは、この削除操作が失敗した場合に操作全体を中止する必要があるかどうかを示します。削除の失敗時に操作を中止する場合は、1を指定します。