am_properties_set()

Sets the value associated with the specified key.

Syntax

#include "am_properties.h"
AM_EXPORT am_status_t
am_properties_set(am_properties_t properties, const char *key,
             const char *value);

Parameters

This function takes the following parameters:

properties

Handle to the properties object to be modified.

key

The key to modify.

value

The value to associate with the specified key.

Returns

This function returns am_status_t with one of the following values:

AM_SUCCESS

If no error is detected.

AM_INVALID_ARGUMENT

If the properties, key, or value argument is NULL.

AM_NO_MEMORY

If unable to allocate memory to store the new key/value.

Details

The specified value will replace any previously existing value.