>The docs say nothing about what has happened or not happened when the result value is not zero.

It's how much memory is committed and could not be freed. I'll file a doc bug, because the documented result is not entirely accurate.