NonStop SOAP 4.1 User's Manual

Return Values:
This function returns a pointer to the newly created log structure.
Utilities For Error Reporting
The following functions set the error code and error message during run time.
The axutil_error_free() Function
Synopsis:
AXIS2_EXTERN void axutil_error_free
( struct axutil_error * error)
Description:
This function de-allocates an error structure instance.
Parameters:
error
is a pointer to an error structure instance to be freed.
Return Values:
Void.
The axutil_error_get_message() Function
Synopsis:
AXIS2_EXTERN const axis2_char_t* axutil_error_get_message
( const struct axutil_error * error )
Description:
This function gets the error message corresponding to the last error occurred.
Parameters:
error
is a pointer to an error structure instance.
Return Values:
This function returns the error message.
The axutil_error_set_error_message() Function
Synopsis:
AXIS2_EXTERN axis2_status_t axutil_error_set_error_message
( struct axutil_error * error,
axis2_char_t * message )
Description:
This function sets error message to the given value.
Parameters:
error
is a pointer to an error structure instance.
message
is the error message to be set.
Return Values:
• AXIS2_SUCCESS on success.
• AXIS2_FAILURE on failure.
378 NonStop SOAP 4 APIs