NonStop SOAP 4.1 User's Manual

ADB APIs for creating requests
The WSDL2C with ADB (Axis2) data binding creates getter and setter methods at both schema
level and the message level. You can use these APIs to create SOAP requests. You must implement
the following functions to develop applications using NonStop SOAP 4 client ADB APIs.
• “The adb_<messagename>_create()Function”
• “The adb_<messagename>_free()Function”
• “The adb_<complextype>_create_with_values() Function”
• “The adb_<messagename>_set_<complextype>() Function”
• “The adb_<messagename>_get_<complextype>() Function”
The adb_<messagename>_create()Function
The adb_<messagename>_create() function creates and returns a pointer to the
<messagetype> structure. This function allocates memory for the <messagetype> structure and
initializes the structure parameters with default values.
Synopsis:
adb_<messagetype> * AXIS2_CALL adb_<messagename>_create
(axutil_env_t *env)
Parameters:
env
is an input parameter and points to the axutil_env_t environment structure. The value
cannot be NULL.
Return value:
The function returns a pointer to the adb_<messagetype> structure. It returns NULL in case of
an error and sets the corresponding error code in the environment's error structure.
The adb_<messagename>_free()Function
The adb_<messagename>_free()function frees the memory allocated to a <messagetype>
structure.
Synopsis:
axis2_status_t AXIS2_CALL adb_<messagename>_free
(<messagetype *> _object, const axutil_env_t *env)
Parameters:
_object
is an input parameter and points to the structure to be freed. The value cannot be NULL.
env
is an input parameter and points to the axutil_env_t structure.
Return value:
The return value is the status of the operation. The function returns AXIS2_SUCCESS if the object
is freed, else returns AXIS2_FAILURE.
The adb_<complextype>_create_with_values() Function
The adb_<complextype>_create_with_values() function creates and returns a pointer to
the <complextype> element in the NonStop SOAP 4 client structure. This function also allocates
memory to the <complextype> element in the structure and initializes the structure parameters
with the values provided.
NonStop SOAP 4 Client APIs 117