cniGetComplexAttribute

Use cniGetComplexAttribute to locate the user-defined properties of the node within the deployment message.

Returns a pointer to the part of the deployment message representing the user-defined properties of the node.

Syntax

CciElement* cniGetComplexAttribute(
  int*                  returnCode,
  CciNode*              nodeObject,
  CciChar*              attributeName);

Parameters

returnCode

The return code from the function (output).

Possible return codes are:

CCI_SUCCESS
CCI_EXCEPTION

nodeObject

The name of the node for which attributes are required (input).

attributeName

The name and value of the user-defined attribute for the selected node.

Return values

Returns a syntax element tree that can be navigated to extract the names and values of all user-defined properties for that node, or NULL if no user-defined properties exist for this node. If an error occurs, the returnCode parameter indicates the reason for the error.