General Notes About the Return Value

•   Zero (or with some functions a positive return value) generally means that the function was successful, though there are some exceptions to this rule.

•   A negative return value, apart from exceptional cases, indicates an error, which shows the reason with the corresponding error constants.