Sets a named HTTP multipart header using a string value.


   name STRING,
   value STRING )
  1. name specifies the multipart header name.
  2. value specifies the multipart header value (such as HTTP headers).


Use this method to set HTTP multipart headers.

For instance, when you send a multipart image, it is recommended that you specify the image mime type with this header method. If the image is a png, you have to do part.setHeader("Content-Type","image/png"), which allows the peer to know the format of the attached file it has to process.

In case of related multipart (i.e., the part is multipart/related and set via the com.HttpRequest.setMultipartType("related",NULL,NULL)), it is mandatory to set a unique Content-ID header. To set up a unique Content-ID header, use the security.RandomGenerator.CreateUUIDString method.

In case of error, the method throws an exception and sets the status variable. Depending on the error, a human-readable description of the problem is available in the sqlca.sqlerrm register. See Error handling in GWS calls (status).


CALL req.setHeader("MyClientHeader","Hello")