com.HttpRequest.doDataRequest

Performs the request by sending binary data.

Syntax

doDataRequest(
   b BYTE )
  1. b defines the binary data.

Usage

Performs the request by sending binary data contained in the b variable.

Supported methods are: PUT, POST, PATCH, and DELETE.
Warning:

A message body is allowed in a DELETE request, but servers may ignore it if they do not support it.

The b must be located in memory and not NULL otherwise the operation fails.

The default Content-Type header is application/octet-stream, but it can be changed to any other mime type. For example: image/jpeg.

In HTTP 1.1, if the body size is greater than 32k, the request will be sent in several chunks of the same size.

This HTTP request method is non-blocking. It returns immediately after the call. Use the com.HttpRequest.getResponse method, to perform a synchronous HTTP request, suspending the program flow until the response returns from the server. If the program must keep going, use the com.HttpRequest.getAsyncResponse method, to check if a response is available.

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).

The int_flag variable is checked during GWS API call to handle program interruptions, for more details, see Interruption handling in GWS calls (int_flag)