NonStop SOAP 4.1 User's Manual

Description:
This function engages the named module. The engaged modules extend the message processing
when consuming services. Modules help to apply QoS norms in messaging. After a module is
engaged to a service client, the axis2_engine invokes the module for all the interactions between
the client and the service.
Parameters:
svc_client
pointer to service client struct.
env
is a pointer to the environment struct. The env parameter must not be NULL.
module_name
name of the module to be engaged.
Return Values:
This function returns AXIS2_SUCCESS on success, else returns AXIS2_FAILURE.
axis2_svc_client_disengage_module
Synopsis:
AXIS2_EXTERN axis2_status_t axis2_svc_client_disengage_module
( axis2_svc_client_t * svc_client,
const axutil_env_t * env,
const axis2_char_t * module_name )
Description:
This function disengages the specified module. Disengaging a module on a service client ensures
that the axis2_engine does not invoke the specified module when sending and receiving
messages.
Parameters:
svc_client
pointer to service client struct.
env
is a pointer to the environment struct. The env parameter must not be NULL.
module_name
name of the module to be engaged.
Return Values:
This function returns AXIS2_SUCCESS on success, else returns AXIS2_FAILURE.
axis2_svc_client_add_header
Synopsis:
AXIS2_EXTERN axis2_status_t axis2_svc_client_add_header \
( axis2_svc_client_t * svc_client,
const axutil_env_t * env,
axiom_node_t * header )
Description:
This function adds an XML element as a header to be sent to the server side. This enables users to
go beyond the usual XML-in/XML-out pattern, and send custom SOAP headers. After being added,
the service client owns the header and cleans up when the service client is freed.
Parameters:
svc_client
pointer to service client struct.
env
is a pointer to the environment struct. The env parameter must not be NULL.
Client API Module 345