cniSetElementNamespace

Sets the namespace attribute for the specified syntax element.

This is used when manipulating a message that belongs to a namespace-aware domain.

Syntax

void cniSetElementNamespace(
	int*           returnCode,
	CciElement*    targetElement,
	const CciChar* nameSpace)		

Parameters

returnCode
The return code from the function (output). Specifying a NULL pointer signifies that the node does not want to deal with errors. If input is not NULL, the output signifies the success status of the call. Any exceptions thrown during the execution of this call are re-thrown to the next upstream node in the flow. Call cciGetLastExceptionData for details of the exception.
Possible return codes are:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
targetElement
Specifies the address of the target syntax element object (input).
value
Specifies the address of a null terminated string of CciChars representing the namespace value (output). An empty string is a valid value for namespace. By default, elements are created in the empty string namespace, so you could specify an empty string as the namespace, but it only has an effect if the element was previously in another namespace and you want to change the namespace value to empty string.

Return values

None. If an error occurs, the returnCode parameter indicates the reason for the error.