           curl_multi_info_read - read multi stack informationals

## SYNOPSIS

           #include <curl/curl.h>

           CURLMsg *curl_multi_info_read( CURLM *multi_handle,
                                          int *msgs_in_queue);

## DESCRIPTION

           Ask  the  multi  handle if there are any messages/informa-
           tionals  from  the  individual  transfers.  Messages   may
           include  informationals  such  as  an  error code from the
           transfer or just the fact that a  transfer  is  completed.
           More details on these should be written down as well.

           Repeated  calls  to this function will return a new struct
           each time, until a NULL is returned as a signal that there
           is  no  more  to get at this point. The integer pointed to
           with msgs_in_queue will contain the  number  of  remaining
           messages after this function was called.

           The  data  the returned pointer points to will not survive
           calling curl_multi_cleanup().

           The 'CURLMsg' struct is very simple and only contain  very
           basic  informations.   If  more  involved  information  is
           wanted, the particular "easy handle" in  present  in  that
           struct   and  can  thus  be  used  in  subsequent  regular
           curl_easy_getinfo() calls (or similar):

            struct CURLMsg {
              CURLMSG msg;       /* what this message means */
              CURL *easy_handle; /* the handle it concerns */
              union {
                void *whatever;    /* message-specific data */
                CURLcode result;   /* return code for transfer */
              } data;
            };

## RETURN VALUE

           A pointer to a filled-in struct, or NULL if it  failed  or
           ran  out of structs. It also writes the number of messages
           left in the queue (after this read)  in  the  integer  the
           second argument points to.

## SEE ALSO

           curl_multi_cleanup(3), curl_multi_init(3), curl_multi_per-
           form(3)