cniSetInputBuffer

Start of changeUsing this function, the caller can supply a buffer. It is used by input nodes only. The address is specified by the source parameter as an input bit stream of the input message to the broker. 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 broker takes a copy of the data and the caller can free the storage on return.End of change

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, the returnCode parameter indicates the reason for the error.

Example

   cniSetInputBuffer(&rc, message, buffer, buflen);
Related concepts
User-defined input nodes