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 was detected.
If unable to allocate memory for the key iterator.
If the value_iter_ptr argument is NULL.
If the specified key is not found in the map.