NonStop SOAP 4.1 User's Manual

Parameters:
document
is an input parameter and is a pointer to the axiom_document_t structure to be built.
env
is an input parameter and is a pointer to the environment structure. It cannot have a NULL
value.
Return Value:
Pointer to the AXIOM node built from the document. If an error occurs, it returns NULL.
The axiom_document_free()Function
The axiom_document_free()function is used to free the document structure from memory.
Synopsis:
AXIS2_EXTERN void axiom_document_free
( struct axiom_document_t* document,
const axutil_env_t * env)
Parameters:
document
is an input parameter and is a pointer to the document structure that becomes free from the
memory.
env
is an input parameter and is a pointer to the environment structure. It cannot have a NULL
value.
Return values:
None.
Consuming the Response AXIOM node using NonStop SOAP 4 APIs
NonStop SOAP 4 provides the following functions to consume the response AXIOM node:
• “The axiom_element_get_qname()Function” (page 111)
• “The axiom_node_get_data_element()Function” (page 90)
• “The axiom_attribute_get_qname()Function” (page 112)
• “The axiom_element_get_attribute()Function” (page 112)
The axiom_element_get_qname()Function
The axiom_element_get_qname()function returns the qualified name of a given AXIOM
element.
Synopsis:
AXIS2_EXTERN axutil_qname_t* axiom_element_get_qname
(axiom_element_t* om_element,
const axutil_env_t * env,
axiom_node_t* om_node)
Parameters:
om_element
is an input parameter and is a pointer to the element whose qname must be retrieved.
env
is an input parameter and is a pointer to the environment structure. It cannot have a NULL
value.
NonStop SOAP 4 Client APIs 111