updated comments and error return value
updated comments and error return value

X-Original-Commit: d0b6d35a879e02dc5bb9c734091c111d1dc10c07

apache/mynewt-nimble,apache/mynewt-nimble,apache/mynewt-nimble,apache/mynewt-nimble,apache/mynewt-nimble