dc_DpwsRequest.h File Reference

HTTP server plug-in interface. More...

#include "dc/dc_Ctypes.h"

Data Structures

struct  media_type_param
 HTTP/MIME media type attribute node. More...
struct  media_type
 HTTP/MIME media type information. More...
struct  transport_fns
 Plugin definition. More...

Typedefs

typedef struct media_type_param media_type_param_t
 HTTP/MIME media type attribute node.
typedef struct media_type media_type_t
 HTTP/MIME media type information.
typedef struct transport_fns transport_fns_t
 Plugin definition.

Functions

DC_RT_FMAC1 int dpws_dispatch_request (struct dpws *dpws, void *transport_data, transport_fns_t *fns, const char *host, const char *path, media_type_t *mtype, const char *action, DC_BOOL needs_length)
 This function processes a single (HTTP) SOAP request.


Detailed Description

HTTP server plug-in interface.

This API defines what should be implemented for external HTTP server integration.


Typedef Documentation

HTTP/MIME media type attribute node.

typedef struct media_type media_type_t

HTTP/MIME media type information.

Plugin definition.


Function Documentation

DC_RT_FMAC1 int dpws_dispatch_request ( struct dpws dpws,
void *  transport_data,
transport_fns_t fns,
const char *  host,
const char *  path,
media_type_t mtype,
const char *  action,
DC_BOOL  needs_length 
)

This function processes a single (HTTP) SOAP request.

It can be called from within the HTTP POST processing function of a Web server. The parameters of this function provide the SOAP processing engine with all necessary information to process the request.

Parameters:
dpws the dpws struct associated to the current request
transport_data an opaque parameter that will be returned in callback functions. Can be used to associate request-specific transport information to the SOAP request.
fns a structure containing the three required callback functions for request processing.
host the host information, as found in the "Host" HTTP header
path the context URL, as found in the HTTP request line. Must be a relative URL
mtype the content type of the request
action the contents of the optional "SOAPAction" HTTP header
needs_length a Boolean indicating to the SOAP processor that it must provide the response length.
Returns:
0 on success, an error code when an error occurred.


Generated on Fri Apr 17 15:18:25 2009 for DPWSCore by  doxygen 1.5.8