cniGetMessageContext

Use this function to get the address of the message context that is associated with the specified message. The context of an existing message is used to create an output message; for example, by using the cniCreateMessage function.

Syntax

CciMessageContext* cniGetMessageContext(
  int*         returnCode,
  CciMessage*  message);

Parameters

returnCode

The return code from the function (output).

Possible return codes are:

CCI_SUCCESS
CCI_INV_MESSAGE_OBJECT

message

The address of the message object (input).

Return values

If successful, the address of the message context is returned. Otherwise, zero (CCI_NULL_ADDR) is returned, and the returnCode parameter indicates the reason for the error.

Example

  outMsg = cniCreateMessage(&rc, cniGetMessageContext(&rc, message));