curl_multi_cleanup

Syntax

#include <curl/curl.h>

CURLMcode curl_multi_cleanup( CURLM *multi_handle );

Parameters

multi_handle Pointer to a multi handle.

Return Values

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

Description

Cleans up and removes a whole multi stack. It does not free or touch any individual easy handles in any way; they still need to be closed individually, using the usual curl_easy_cleanup process. The order of cleaning up should be as follows.

  1. curl_multi_remove_handle before any easy handles are cleaned up.
  2. curl_easy_cleanup can now be called independently since the easy handle is no longer connected to the multi handle.
  3. curl_multi_cleanup should be called when all easy handles are removed.

Do Not Call From

None.

See Also

HTTP Client Library (libcurl)
libcurl API Functions
libcurl Error Codes
curl_multi_init
curl_easy_cleanup
curl_easy_init

Revision History

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


CONFIDENTIAL