NonStop SOAP 4.1 User's Manual

Parameters:
srv_skeleton
is an input parameter which points to the service skeleton structure created in the
axis2_get_instance()function.
env
is an input parameter and is a pointer to the environment structure. It cannot have a NULL
value.
Return values:
• AXIS2_SUCCESS on success.
• AXIS2_FAILURE on failure.
APIs to Extract the Input Parameters and Return the Response
NonStop SOAP 4 calls the invoke() function from the service skeleton operation structure to
pass the request to the Web service in the form of an AXIOM node. After processing the request,
the Web service builds the response in the AXIOM node and returns the response to NonStop
SOAP 4.
The AXIOM APIs, from the NonStop SOAP 4 service APIs, that enable you to read and create
AXIOM nodes are described in the following sections:
• “Reading an AXIOM node using NonStop SOAP 4 APIs” (page 89)
• “Creating an AXIOM node using NonStop SOAP 4 APIs” (page 91)
Reading an AXIOM node using NonStop SOAP 4 APIs
NonStop SOAP 4 provides the following functions to read an AXIOM node to process a request:
• “The axiom_element_get_qname()Function” (page 89)
• “The axiom_node_get_data_element()Function” (page 90)
• “The axiom_attribute_get_qname()Function” (page 90)
• “The axiom_element_get_attribute()Function” (page 90)
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.
om_node
is an input parameter and is a pointer to the axiom_node_t node that contains om_element.
Return Values:
Pointer to the qname of the element. If an error occurs, it returns NULL.
Basic NonStop SOAP 4 Service APIs 89