curl_multi_remove_handle

Syntax

#include <curl/curl.h>

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

Parameters

multi_handle Pointer to a multi handle.
easy_handle Pointer to an easy handle.

Return Values

If the operation was successful, CURLEM_OK is returned. Otherwise, a specific CURLM libcurl Error Code is returned.

Description

Removes a given easy_handle from the multi_handle. This will remove the specified easy handle from this multi handle's control. When the easy handle has been removed from a multi stack, it is again legal to invoke curl_easy_perform on this easy handle. Removing an easy handle while being used, will halt the transfer in progress that involves the easy handle. All other easy handles and transfers will remain unaffected.

Do Not Call From

None.

See Also

HTTP Client Library (libcurl)
libcurl API Functions
libcurl Error Codes
curl_multi_cleanup
curl_multi_init

Revision History

2013/09/18 Conversion
2013/05/08 Automated cleanup pass.
2012/05/04 Initial version.


CONFIDENTIAL