This function imports a Resource Manager favorites list from the specified file. If the optional merge parameter is set to 0, the current favorites list is replaced by the imported list. If merge is omitted or set to any non-zero value, the imported list is appended to the current list of favorites. In this case, any duplicate entries are not added to the list.

The function returns 1 on success or 0 on failure.