This function declares the node as an input node. Message processing nodes and output nodes do not use it, and you do not need to call cniEvaluate. The broker allocates a thread and invokes this function on that thread.
Defined In | Type | Member |
---|---|---|
CNI_VFT | Conditional | iFpRun |
int cniRun( CCiContext* context, CCiMessage* localEnvironment, CciMessage* exceptionList, CciMessage* message );
For compatibility with earlier versions, you can refer to this parameter as destinationList.
The user-defined node can call cniSetInputBuffer to associate a bit stream with this message. Populating the tree of this message is not supported, therefore calls to functions such as cniAddAsLastChild or cniCreateElementAsLastChildFromBitstream do not work. To build parts of the tree, create a new message using cniCreateMessage rather than providing a buffer to be parsed as the whole message.
This function is called by the broker as part of a loop. The meaning of the return value is as follows: