curl_multi_add_handle(3)  libcurl Manual curl_multi_add_handle(3)



NAME
       curl_multi_add_handle - add an easy handle to a multi ses-
       sion

SYNOPSIS
       #include 

       CURLMcode curl_multi_add_handle(CURLM *multi_handle,  CURL
       *easy_handle);

DESCRIPTION
       Adds a standard easy handle to the multi stack. This func-
       tion call will make this multi_handle control  the  speci-
       fied easy_handle.

       When  an  easy handle has been added to a multi stack, you
       can not and you must not use curl_easy_perform(3) on  that
       handle!

       If  the  easy  handle  is  not  set  to use a shared (CUR-
       LOPT_SHARE)     or     global     DNS     cache      (CUR-
       LOPT_DNS_USE_GLOBAL_CACHE), it will be made to use the DNS
       cache that is shared between all easy handles  within  the
       multi handle when curl_multi_add_handle(3) is called.

       The  easy  handle  will  remain  added until you remove it
       again with curl_multi_remove_handle(3). You should  remove
       the  easy handle from the multi stack before you terminate
       first the easy handle and then the multi handle:

       1 - curl_multi_remove_handle(3)

       2 - curl_easy_cleanup(3)

       3 - curl_multi_cleanup(3)

RETURN VALUE
       CURLMcode type,  general  libcurl  multi  interface  error
       code.

SEE ALSO
       curl_multi_cleanup(3),curl_multi_init(3)



libcurl 7.9.5              4 March 2002  curl_multi_add_handle(3)