![]() | ![]() | ![]() | libsoup Reference Manual | ![]() |
---|
SoupConnection —
#define SOUP_CONNECTION_ORIGIN_URI #define SOUP_CONNECTION_PROXY_URI #define SOUP_CONNECTION_SSL_CREDENTIALS SoupConnection* soup_connection_new (const char *propname1, ...); void (*SoupConnectionCallback) (SoupConnection *sock, guint status, gpointer data); void soup_connection_connect_async (SoupConnection *conn, SoupConnectionCallback callback, gpointer user_data); guint soup_connection_connect_sync (SoupConnection *conn); void soup_connection_disconnect (SoupConnection *conn); gboolean soup_connection_is_in_use (SoupConnection *conn); time_t soup_connection_last_used (SoupConnection *conn); void soup_connection_send_request (SoupConnection *conn, SoupMessage *req); void soup_connection_authenticate (SoupConnection *conn, SoupMessage *msg, const char *auth_type, const char *auth_realm, char **username, char **password); void soup_connection_reauthenticate (SoupConnection *conn, SoupMessage *msg, const char *auth_type, const char *auth_realm, char **username, char **password);
SoupConnection* soup_connection_new (const char *propname1, ...);
Creates an HTTP connection. You must set at least one of SOUP_CONNECTION_ORIGIN_URI or SOUP_CONNECTION_PROXY_URI. If you set an origin server URI but no proxy URI, this will be a direct connection. If you set a proxy URI and an https origin server URI, this will be a tunnel. Otherwise it will be an http proxy connection.
You must call soup_connection_connect_async() or soup_connection_connect_sync() to connect it after creating it.
propname1 : | name of first property to set |
... : | |
Returns : | the new connection (not yet ready for use). |
void (*SoupConnectionCallback) (SoupConnection *sock, guint status, gpointer data);
sock : | |
status : | |
data : |
void soup_connection_connect_async (SoupConnection *conn, SoupConnectionCallback callback, gpointer user_data);
Asynchronously connects conn.
conn : | the connection |
callback : | callback to call when the connection succeeds or fails |
user_data : | data for callback |
guint soup_connection_connect_sync (SoupConnection *conn);
Synchronously connects conn.
conn : | the connection |
Returns : | the soup status |
void soup_connection_disconnect (SoupConnection *conn);
Disconnects conn's socket and emits a disconnected signal. After calling this, conn will be essentially useless.
conn : | a connection |
gboolean soup_connection_is_in_use (SoupConnection *conn);
conn : | a connection |
Returns : | whether or not conn is being used. |
time_t soup_connection_last_used (SoupConnection *conn);
conn : | a SoupConnection. |
Returns : | the last time a response was received on conn, or 0 if conn has not been used yet. |
void soup_connection_send_request (SoupConnection *conn, SoupMessage *req);
conn : | |
req : |
void soup_connection_authenticate (SoupConnection *conn, SoupMessage *msg, const char *auth_type, const char *auth_realm, char **username, char **password);
conn : | |
msg : | |
auth_type : | |
auth_realm : | |
username : | |
password : |
void soup_connection_reauthenticate (SoupConnection *conn, SoupMessage *msg, const char *auth_type, const char *auth_realm, char **username, char **password);
conn : | |
msg : | |
auth_type : | |
auth_realm : | |
username : | |
password : |
<< SoupAuthDigest | SoupConnectionNTLM >> |