SoupSession 3 LIBSOUP Library
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_PROXY_URI

### SOUP_SESSION_MAX_CONNS

    #define SOUP_SESSION_MAX_CONNS          "max-conns"

SOUP_SESSION_MAX_CONNS

### SOUP_SESSION_MAX_CONNS_PER_HOST

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

SOUP_SESSION_MAX_CONNS_PER_HOST

### SOUP_SESSION_USE_NTLM

    #define SOUP_SESSION_USE_NTLM           "use-ntlm"

SOUP_SESSION_USE_NTLM

### SOUP_SESSION_SSL_CA_FILE

    #define SOUP_SESSION_SSL_CA_FILE        "ssl-ca-file"

SOUP_SESSION_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_queue_message

### 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_requeue_message

### 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_send_message

### soup_session_abort ()

    void        soup_session_abort              (SoupSession *session);

Cancels all pending requests in session.

session :

  the session

soup_session_abort