This function returns one of the following values of the am_status_t enumeration (defined in the <am_types.h> header file):
If no error is detected.
If the properties, key, or value argument is NULL.
If unable to allocate memory to store the new key/value.