Name

ne_session_create, ne_close_connection, ne_session_server, ne_session_destroy — Manipulate HTTP sessions

Synopsis

#include <ne_session.h>

ne_session *ne_session_create();

int ne_session_server(session, hostname, port);
ne_session *session;
const char *hostname;
int port;

int ne_close_connection(session);
ne_sesssion *session;

void ne_session_destroy(session);
ne_session *session;

Description

An ne_session * object is used to group a sequence of HTTP requests made to a server, enabling the use of a persistent connection to be used across all the requests, shared authentication credentials, and more.

The ne_session_server call sets the server to be used for the session. This function must be called before any requests are made using the session.

Return Values

On success, ne_session_server returns 0 (NE_OK), or a non-zero value if an error occurred.

Errors

NE_LOOKUP: the hostname cannot be resolved.

Examples

Create and initialize a session:


  ne_session *sess = ne_session_create();
  if (ne_session_server(sess, "my.host.name", 80) == NE_LOOKUP) {
     printf("Host not found!");
  } else {
     /* ... use sess ... */
  }
  ne_session_destroy(sess);