be conform to the iterator APIs exposed for linklists and hashtables

so that return codes have always the same meaning across the varous APIs