1curl_multi_remove_handle(3)         libcurl        curl_multi_remove_handle(3)
2
3
4

NAME

6       curl_multi_remove_handle - remove an easy handle from a multi session
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLMcode curl_multi_remove_handle(CURLM *multi_handle, CURL *easy_handle);
12

DESCRIPTION

14       Removes  a  given easy_handle from the multi_handle. This will make the
15       specified easy handle be removed from this multi handle's control.
16
17       When the easy handle has been removed from a multi stack, it  is  again
18       perfectly legal to invoke curl_easy_perform(3) on this easy handle.
19
20       Removing  an  easy  handle while being used is perfectly legal and will
21       effectively halt the transfer in progress involving that  easy  handle.
22       All other easy handles and transfers will remain unaffected.
23
24       It  is  fine to remove a handle at any time during a transfer, just not
25       from within any libcurl callback function.
26

EXAMPLE

28       /* when an easy handle has completed, remove it */
29       msg = curl_multi_info_read(multi_handle, &queued);
30       if(msg) {
31         if(msg->msg == CURLMSG_DONE) {
32           /* a transfer ended */
33           fprintf(stderr, "Transfer completed\n");
34           curl_multi_remove_handle(multi_handle, msg->easy_handle);
35         }
36       }
37

AVAILABILITY

39       Added in 7.9.6
40

RETURN VALUE

42       CURLMcode type, general libcurl multi interface error code.
43

SEE ALSO

45       curl_multi_cleanup(3),curl_multi_init(3), curl_multi_add_handle(3)
46
47
48
49libcurl 8.2.1                   April 26, 2023     curl_multi_remove_handle(3)
Impressum