The number of bytes actually read (between 1 and sz) if the operation is successful, or the constant IO_EOF or IO_ERROR for end of file or error.
