DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

curl_mime_headers(3)




curl_mime_headers(3)     libcurl Manual      curl_mime_headers(3)


NAME

     curl_mime_headers - set a mime part's custom headers


SYNOPSIS

     #include <curl/curl.h>

     CURLcode  curl_mime_headers(curl_mimepart  *  part,   struct
     curl_slist * headers, int take_ownership);


DESCRIPTION

     curl_mime_headers(3) sets a mime part's custom headers.

     part is the part's handle to assign the custom headers  list
     to.

     headers is the head of a list of custom headers; it  may  be
     set  to  NULL  to remove a previously attached custom header
     list.

     take_ownership: when non-zero, causes the list to  be  freed
     upon  replacement  or  mime structure deletion; in this case
     the list must not be freed explicitly.

     Setting a part's custom headers list twice  is  valid:  only
     the value set by the last call is retained.


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

      struct curl_slist *headers = NULL;

      headers = curl_slist_append("Custom-Header: mooo", headers);

      /* use these headers, please take ownership */
      curl_mime_headers(part, headers, TRUE);

      /* pass on this data */
      curl_mime_data(part, "12345679", CURL_ZERO_TERMINATED);

      /* set name */
      curl_mime_name(part, "numbers");


SEE ALSO

     curl_mime_addpart(3)

libcurl 7.58.0   Last change: September 22, 2017                1


Man(1) output converted with man2html