Marwan Kallal

Add error handling to possible failure points by returning an error code, and document any that we use for better control by the calling application.