Returns

This function returns one of the following values:

AM_SUCCESS

If the operation was successful.

AM_INVALID_ARGUMENT

If properties argument is NULL.