## SoupSession

SoupSession —

## Synopsis

    #define     SOUP_SESSION_PROXY_URI
    #define     SOUP_SESSION_MAX_CONNS
    #define     SOUP_SESSION_MAX_CONNS_PER_HOST
    #define     SOUP_SESSION_USE_NTLM
    #define     SOUP_SESSION_SSL_CA_FILE
    void        soup_session_queue_message      (SoupSession *session,
                                                 SoupMessage *msg,
                                                 SoupMessageCallbackFn callback,
                                                 gpointer user_data);
    void        soup_session_requeue_message    (SoupSession *session,
                                                 SoupMessage *msg);
    guint       soup_session_send_message       (SoupSession *session,
                                                 SoupMessage *msg);
    void        soup_session_abort              (SoupSession *session);

## Description

## Details

### SOUP_SESSION_PROXY_URI

    #define SOUP_SESSION_PROXY_URI          "proxy-uri"

### SOUP_SESSION_MAX_CONNS

    #define SOUP_SESSION_MAX_CONNS          "max-conns"

### SOUP_SESSION_MAX_CONNS_PER_HOST

    #define SOUP_SESSION_MAX_CONNS_PER_HOST "max-conns-per-host"

### SOUP_SESSION_USE_NTLM

    #define SOUP_SESSION_USE_NTLM           "use-ntlm"

### SOUP_SESSION_SSL_CA_FILE

    #define SOUP_SESSION_SSL_CA_FILE        "ssl-ca-file"

### soup_session_queue_message ()

    void        soup_session_queue_message      (SoupSession *session,
                                                 SoupMessage *msg,
                                                 SoupMessageCallbackFn callback,
                                                 gpointer user_data);

Queues the message `msg` for sending. All messages are processed while the glib main loop runs. If `msg` has been processed before, any resources related to the time it was last sent are freed.

Upon message completion, the callback specified in `callback` will be invoked. If after returning from this callback the message has not been requeued, `msg` will be unreffed.

`session` : | a SoupSession
`msg` : | the message to queue
`callback` : | a SoupMessageCallbackFn which will be called after the message completes or when an unrecoverable error occurs.
`user_data` : | a pointer passed to `callback`.

### soup_session_requeue_message ()

    void        soup_session_requeue_message    (SoupSession *session,
                                                 SoupMessage *msg);

This causes `msg` to be placed back on the queue to be attempted again.

`session` : | a SoupSession
`msg` : | the message to requeue

### soup_session_send_message ()

    guint       soup_session_send_message       (SoupSession *session,
                                                 SoupMessage *msg);

Synchronously send `msg`. This call will not return until the transfer is finished successfully or there is an unrecoverable error.

`msg` is not freed upon return.

`session` : | a SoupSession
`msg` : | the message to send
Returns : | the HTTP status code of the response

### soup_session_abort ()

    void        soup_session_abort              (SoupSession *session);

Cancels all pending requests in `session`.

`session` : | the session