NonStop SOAP 4.1 User's Manual

NOTE: The axis2_svc_client_create()and axis2_svc_client_free()functions are
generated by the WSDL2C tool for NonStop SOAP 4 clients. This tool consumes the WSDL file of
the service to generate client stubs which contain the definition for these functions. For more
information about the WSDL2C tool, see “NonStop SOAP Tools” (page 194).
The axis2_svc_client_create()Function
The axis2_svc_client_create() function creates and returns a pointer to the
axis2_svc_client_t NonStop SOAP 4 client structure. This function also allocates memory to
the service client structure and initializes the structure parameters to contain default values.
Synopsis:
AXIS2_EXTERN axis2_svc_client_t* axis2_svc_client_create
( const axutil_env_t * env,
const axis2_char_t * client_home
)
Parameters:
env
is an input parameter and is a pointer to the environment structure. It cannot have a NULL
value.
client_home
is name of the directory that contains the Axis2/C repository.
Return values:
Pointer to the newly created service client structure. It returns NULL in case of an error and sets the
corresponding error code in environment's error structure.
The axis2_svc_client_free()Function
The axis2_svc_client_free() function frees the NonStop SOAP 4 client structure from
memory. This function is called to release the memory allocated to the service client structure that
is no longer needed. This helps in reducing the memory footprint of the NonStop SOAP 4 client.
Synopsis:
AXIS2_EXTERN void axis2_svc_client_free
( axis2_svc_client_t * svc_client,
const axutil_env_t * env
)
Parameters:
svc_client
is a pointer to the service client structure.
env
is an input parameter and is a pointer to the environment structure. It cannot have a NULL
value.
Return values:
None
APIs to Generate the Request Node and Consume the Response Node
NonStop SOAP 4 client sends a request and receives a response from the Nonstop SOAP 4 server
in the form of an AXIOM node.
106 NonStop SOAP 4 Client APIs