cniCreateMessage

Esta función crea un nuevo objeto de mensaje de salida. Para cada llamada a esta función, deberá haber una llamada coincidente a cniDeleteMessage para devolver recursos asignados cuando el proceso en el mensaje de salida se haya completado.

Sintaxis

CciMessage* cniCreateMessage(
  int*                returnCode,
  CciMessageContext*  messageContext);

Parámetros

returnCode
Código de retorno de la función (salida).
messageContext
Dirección del contexto para el mensaje (entrada). Utilice cniGetMessageContext para obtener el contexto de un mensaje entrante (por ejemplo, un mensaje recibido en la función cniEvaluate).

Valores de retorno

Si la función se ejecuta correctamente, se devuelve la dirección del objeto de mensaje. De lo contrario, se devuelve el valor cero (CCI_NULL_ADDR), y el parámetro returnCode indica la causa del error.

Ejemplo

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

Conceptos relacionados
Nodos de entrada definidos por el usuario
Nodos de proceso de mensajes definidos por el usuario
Nodos de salida definidos por el usuario

Tareas relacionadas
Creación de un nodo de entrada en C
Creación de un nodo de proceso de mensajes en C

Referencia relacionada
Funciones de programa de utilidad de nodo de lenguaje C
cniDeleteMessage
cniEvaluate
cniFinalize
cniGetEnvironmentMessage
cniGetMessageContext
cniPropagate