NonStop SOAP 4.1 User's Manual

Parameters:
MessageReceiverUserFunctions
is an input parameter and is a pointer to the address of the
axis2_MessageReceiverUserFunctions_t structure.
payload
is an input parameter and is a pointer to the request message buffer.
env
is an input parameter and is a pointer to the environment structure. It cannot have a NULL
value.
ReqLen
is an input parameter and is a pointer to the request length of the buffer.
in_msg_ctx
is an input parameter and is a pointer to the message context structure for the inflow.
out_msg_ctx
is an input parameter and is a pointer to the message context structure for the outflow.
Return value:
Returns the modified length of the request message buffer as int.
If you want to modify the request buffer in the pre_service function, you must modify the length
of the request buffer (ReqLen) before the returning statement of the pre_service function.
NOTE: For more information on message context structure, see the msg_ctx.h header file
located in the <NonStop SOAP Installation Directory>/include directory.
The pre_marshal Message Receiver User Function
The pre_marshal Message Receiver User Function is called after the response is received from
the Pathway or NonStop process-based service. You can use the pre_marshal Message Receiver
User Function to modify the response message buffer and to skip the response creation.
In the pre_marshal Message Receiver User Function, you can access the service name and the
operation name to perform the service-specific processing and/or operation-specific processing.
Synopsis:
int <service name>_pre_marshal_function(
axis2_MessageReceiverUserFunctions_t *MessageReceiverUserFunctions,
axis2_char_t * payload,
const axutil_env_t * env,
int ResLen,
struct axis2_msg_ctx * in_msg_ctx,
struct axis2_msg_ctx * out_msg_ctx)
Parameters:
MessageReceiverUserFunctions
is an input parameter and is a pointer to the address of the
axis2_MessageReceiverUserFunctions_t structure.
payload
is an input parameter and is a pointer to the response message buffer.
env
is an input parameter and is a pointer to the environment structure. It cannot have a NULL
value.
ResLen
is an input parameter and is a pointer to the response length of the payload.
142 Customizing NonStop SOAP 4 Message Processing