curl_multi_info_read(3) libcurl Manual curl_multi_info_read(3)NAMEcurl_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's any messages/information-
als from the individual transfers. Messages include infor-
mationals 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 special "end of msgs" struct is
returned as a signal that there is no more to get at this
point. The integer pointed to with msgs_in_queue will con-
tain 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).
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 ALSOcurl_multi_cleanup(3),curl_multi_init(3),curl_multi_per-
form(3)libcurl 7.9.5 1 March 2002 curl_multi_info_read(3)