cniGetMessageContext

Esta función obtiene la dirección del contexto de mensaje asociado con el mensaje especificado. El contexto de un mensaje existente se utiliza para crear un mensaje de salida, por ejemplo utilizando la función cniCreateMessage.

Sintaxis

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

Parámetros

returnCode
Código de retorno de la función (salida).
message
Dirección del objeto de mensaje (entrada).

Valores de retorno

Si la función se ejecuta correctamente, se devuelve la dirección del contexto de mensaje. De lo contrario, se devuelve 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
cniCreateMessage
cniDeleteMessage
cniFinalize
cniGetEnvironmentMessage
cniPropagate