calloc: introduce LIBSSH2_CALLOC()

A simple function using LIBSSH2_ALLOC + memset, since this pattern was
used in multiple places and this simplies code in general.
userauth.c: improve readability and clarity of for-loops
examples on Windows: use native SOCKET-type instead of int

And check return values accordingly.