summaryrefslogtreecommitdiffstats
path: root/libcsoap/soap-env.h
diff options
context:
space:
mode:
authorGravatar snowdrop2004-10-28 10:30:41 +0000
committerGravatar snowdrop2004-10-28 10:30:41 +0000
commitd24d6ab7bbfda8e302af3a5cf8be62299d543c1a (patch)
treed5da54889ad987c216d6767e39c65607b4b678e5 /libcsoap/soap-env.h
parentebde083c541b5d202014c41450a3519f4d08e3c9 (diff)
downloadcsoap-d24d6ab7bbfda8e302af3a5cf8be62299d543c1a.tar.gz
csoap-d24d6ab7bbfda8e302af3a5cf8be62299d543c1a.tar.bz2
changed hstatus_t to herror_t and chagend the API function to return herror_t. Added herror_*() functions and fixed a bug in the socket receive comm.
Diffstat (limited to 'libcsoap/soap-env.h')
-rw-r--r--libcsoap/soap-env.h48
1 files changed, 28 insertions, 20 deletions
diff --git a/libcsoap/soap-env.h b/libcsoap/soap-env.h
index 5b3bd7f..58af136 100644
--- a/libcsoap/soap-env.h
+++ b/libcsoap/soap-env.h
@@ -1,5 +1,5 @@
/******************************************************************
- * $Id: soap-env.h,v 1.7 2004/10/15 13:33:13 snowdrop Exp $
+ * $Id: soap-env.h,v 1.8 2004/10/28 10:30:46 snowdrop Exp $
*
* CSOAP Project: A SOAP client/server library in C
* Copyright (C) 2003 Ferhat Ayaz
@@ -50,8 +50,8 @@ typedef struct _SoapEnv
@param faultstring A fault message
@param faultactor The fault actor (This can be NULL)
@param detail The detail of the error (This can be NULL)
-
- @returns A Soap envelope object like follows
+ @param out the result envelope out parameter like follows
+ @returns H_OK if success
<pre>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="..." SOAP-ENV:encoding="..."
@@ -71,11 +71,12 @@ typedef struct _SoapEnv
</pre>
- */
-SoapEnv *soap_env_new_with_fault(fault_code_t faultcode,
+ */
+herror_t
+soap_env_new_with_fault(fault_code_t faultcode,
const char *faultstring,
const char *faultactor,
- const char *detail);
+ const char *detail, SoapEnv **out);
/**
Creates an envelope with a method to invoke a soap service.
@@ -84,7 +85,8 @@ SoapEnv *soap_env_new_with_fault(fault_code_t faultcode,
@param urn The urn of the soap service to invoke
@param method The method name of the soap service
- @returns A Soap envelope object like follows
+ @param out the result envelope out parameter like follows
+ @returns H_OK if success
<pre>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="..." SOAP-ENV:encoding="..."
@@ -101,7 +103,8 @@ SoapEnv *soap_env_new_with_fault(fault_code_t faultcode,
</pre>
*/
-SoapEnv *soap_env_new_with_method(const char *urn, const char *method);
+herror_t
+soap_env_new_with_method(const char *urn, const char *method, SoapEnv **out);
/**
@@ -115,7 +118,8 @@ SoapEnv *soap_env_new_with_method(const char *urn, const char *method);
@param req The request object. A response object will be created
to this request.
- @returns A Soap envelope object like follows
+ @param out the result envelope out paramter like follows
+ @returns H_OK if success
<pre>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="..." SOAP-ENV:encoding="..."
@@ -133,18 +137,19 @@ SoapEnv *soap_env_new_with_method(const char *urn, const char *method);
*/
-SoapEnv *soap_env_new_with_response(SoapEnv *req);
+herror_t soap_env_new_with_response(SoapEnv *req,SoapEnv **out);
/**
Creates an envelope from a given libxml2 xmlDoc
pointer.
- @param doc the xml document pointer
- @returns A Soap envelop object if success,
- NULL otherwise.
+ @param doc the xml document pointer
+ @param out the output envelope object
+ @returns H_OK if success
+
*/
-SoapEnv *soap_env_new_from_doc(xmlDocPtr doc);
+herror_t soap_env_new_from_doc(xmlDocPtr doc, SoapEnv **out);
/**
@@ -152,17 +157,20 @@ SoapEnv *soap_env_new_from_doc(xmlDocPtr doc);
The string must be in xml format.
@param buffer The string to parse into a envelope.
- @returns A soap envelope object if success or
- NULL if the string can not be parsed or the string
- does not represent an soap envelope in xml format.
+ @param out the output envelope object
+ @returns H_OK if success
*/
-SoapEnv *soap_env_new_from_buffer(const char* buffer);
+herror_t soap_env_new_from_buffer(const char* buffer,SoapEnv **out);
/**
- Create an envelope from input stream
+ Create an envelope from input stream
+
+ @param in the input stream object to read from
+ @param out the output envelope object
+ @returns H_OK if success
*/
-SoapEnv *soap_env_new_from_stream(http_input_stream_t *in);
+herror_t soap_env_new_from_stream(http_input_stream_t *in, SoapEnv **out);
/* --------------------------------------------------- */
/* XML Serializer functions and typedefs */