Description

lod_set_curl sets or resets the CURL handle associated with context.

Any existing CURL handle associated with the context will be discarded, freeing it (using curl_easy_cleanup) if it was automatically allocated by liblod, as is the case when a context is initially created.

If handle is NULL, a new CURL handle will be allocated and associated with context. This object will be automatically destroyed when it is no longer required.

If handle is not NULL, then the supplied CURL handle will be associated with context. liblod will not automatically destroy this CURL handle when it is is no longer required, and it is the calling application's responsibility to do so.

Caution

Do not destroy a CURL handle associated with a context until after it has either been replaced (via another call to lod_set_curl), or the context itself has been destroyed (by lod_destroy).

See also

liblod, lod_curl, lod_create, lod_destroy, lod_errmsg, curl_easy_init, curl_easy_cleanup.