curl_mime_subparts

Section: libcurl Manual (3)
Updated: November 05, 2020
Page Index

NAME

curl_mime_subparts - set subparts of a multipart mime part

SYNOPSIS

#include <curl/curl.h>

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

DESCRIPTION

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.

AVAILABILITY

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.

EXAMPLE

TODO