Method

SoupSessionsend

Declaration [src]

GInputStream*
soup_session_send (
  SoupSession* session,
  SoupMessage* msg,
  GCancellable* cancellable,
  GError** error
)

Description [src]

Synchronously sends msg and waits for the beginning of a response.

On success, a GInputStream will be returned which you can use to read the response body. (“Success” here means only that an HTTP response was received and understood; it does not necessarily mean that a 2xx class status code was received.)

If non-NULL, cancellable can be used to cancel the request; soup_session_send() will return a G_IO_ERROR_CANCELLED error. Note that with requests that have side effects (eg, POST, PUT, DELETE) it is possible that you might cancel the request after the server acts on it, but before it returns a response, leaving the remote resource in an unknown state.

If msg is requeued due to a redirect or authentication, the initial (3xx/401/407) response body will be suppressed, and soup_session_send() will only return once a final response has been received.

Parameters

`msg`	`SoupMessage`
	A `SoupMessage`.
	The data is owned by the caller of the function.
`cancellable`	`GCancellable`
	A `GCancellable`.
	The argument can be `NULL`.
	The data is owned by the caller of the function.
`error`	`GError **`
	The return location for a `GError*`, or `NULL`.

Return value

Returns:	`GInputStream`
	A `GInputStream` for reading the response body, or `NULL` on error.
	The caller of the method takes ownership of the data, and is responsible for freeing it.