cniSetInputBuffer

Use this function to supply a buffer. It is used only by input nodes. The address is specified by the source parameter as an input bit stream of the input message to the integration node.

By supplying a buffer, an input node can read data into the bit stream that represents an input message from an external data source. The integration node takes a copy of the data and the caller can free the storage on return.

Syntax

int cniSetInputBuffer(
  void*        returnCode,
  CciMessage*  message,
  Void*        source,
  CCiInt       length);

Parameters

returnCode

The return code from the function (output).

Possible return codes are:

CCI_SUCCESS
CCI_EXCEPTION
CCI_INV_MESSAGE_OBJECT
CCI_INV_DATA_POINTER
CCI_INV_DATA_BUFLEN

message

The message object that uses the buffer described by the source parameter to represent the input bit stream. (input)

source

The address of the buffer to be used as input. (input)

length

The length of the input buffer described by the source parameter. (input)

Return values

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

Example

   cniSetInputBuffer(&rc, message, buffer, buflen);