NonStop SOAP 4.1 User's Manual

where,
env
is an input parameter and is a pointer to the environment structure. It cannot have a NULL
value.
Return Values:
Returns a pointer to the axis2_MessageReviverUserFunction_t structure. If an error occurs,
it returns NULL.
Setting pre_service and pre_marshal function names
After you create a pointer of the Message Receiver User Functions structure, the callback functions
that implement the pre_service and pre_marshal functions must be set in the Message
Receiver User Functions structure pointer.
This section includes the following topics:
• “Setting the name of the pre_service callback function in the Message Receiver User
Functions structure” (page 140)
• “Setting the name of the pre_marshal callback function in the Message Receiver User
Functions” (page 140)
Setting the name of the pre_service callback function in the Message Receiver User Functions structure
To set the name of the pre_service callback function in the Message Receiver User Functions
structure, invoke the axis2_msg_recv_set_pre_service_function() API from the
get_instance() function.
Synopsis:
AXIS2_EXPORT axis2_status_t axis2_msg_recv_set_pre_service_function (
struct axis2_MessageReceiverUserFunctions *inst,
const axutil_env_t * env
PRE_SERVICE_FUNCTION func)
Parameters:
inst
is an input parameter and is a pointer to the Message Receiver User Functions structure created
using the MessageReceiverUserFunctions_create() function.
env
is an input parameter and is a pointer to the environment structure. It cannot have a NULL
value.
func
is an input parameter that holds the name of function that implements the pre_service
functionality.
Return Values:
• AXIS2_SUCCESS on success.
• AXIS2_FAILURE on failure.
Setting the name of the pre_marshal callback function in the Message Receiver User Functions
To set the name of the pre_marshal callback function in the Message Receiver User Functions
structure, invoke the axis2_msg_recv_set_pre_marshal_function() API from the
get_instance() function.
Synopsis:
AXIS2_EXPORT axis2_status_t axis2_msg_recv_set_pre_marshal_function (
struct axis2_MessageReceiverUserFunctions *inst,
140 Customizing NonStop SOAP 4 Message Processing