curl_mime_subparts - Man Page

set subparts of a multipart mime part


#include <curl/curl.h>

CURLcode curl_mime_subparts(curl_mimepart * part, curl_mime * subparts);


curl_mime_subparts(3) sets a multipart mime part's content from a mime structure.

part is a handle to the multipart part.

subparts is a mime structure handle holding the subparts. After curl_mime_subparts succeeds, the mime structure handle belongs to the multipart part and must not be freed explicitly. It may however be updated by subsequent calls to mime API functions.

Setting a part's contents twice is valid: only the value set by the last call is retained. It is possible to unassign previous part's contents by setting subparts to NULL.


As long as at least one of HTTP, SMTP or IMAP is enabled. Added in 7.56.0.

Return Value

CURLE_OK or a CURL error code upon failure.



See Also

curl_mime_addpart(3), curl_mime_init(3)

Referenced By

curl_mime_addpart(3), curl_mime_encoder(3), libcurl-tutorial(3).

November 05, 2020 libcurl 7.79.1 libcurl Manual