Thanks for your contribution. I've added it to the bugtracker as proposed for inclusion.
Instead of return true, I changed to return SUCCESS
and Instead of return false, I changed to return FAIL
Thats inconsistent with the other api functions, so I will have to change that to true/false before we can include your code.