20.1.11 ead_update() (updates a value)

(1) Description

This function stores a value with a specified key only if the key is already stored (updates the value).

To Page Top

(2) Format

#include <eads.h>
void ead_update
(
  const EAD_CACHE             *cp,            /* In */
  const char                  *key,           /* In */
  const ead_value_element     *value,         /* In */
  int                         *error_code     /* Out */
);

To Page Top

(3) Arguments

cp

Specifies the handle (pointer) to the cache where the key and value are to be stored.

Specify the handle obtained from ead_start_cache().

key

Specifies the key to associate with the value.

For details about the data types that can be specified, see 15.2.2(1) Data types that can be specified as keys.

value

Specifies the value information (ead_value_element structure) to store.

For details about the ead_value_element structure, see 20.1.39 ead_value_element structure (value information).

error_code

Specifies the pointer from which to retrieve the error code.

For details about error codes, see 20.2 Error codes in the client library (C).

To Page Top