WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

cciPropagatedMessageCallback

La función cciPropagatedMessageCallback se puede registrar como una devolución de llamada y se invoca cuando se propaga un mensaje de un nodo a otro.

La función cciPropagatedMessageCallback invoca para cada mensaje que se ha propagado en el grupo de ejecución en el que se ha registrado la llamada de devolución, si la salida de usuario está en estado activo. La llamada de devolución se registra proporcionando un puntero a la función como el campo iFpPropagatedMessageCallback de la estructura CCI_UE_VFT que se ha pasado a cciRegisterUserExit.

Sintaxis

typedef void (*cciPropagatedMessageCallback)( 
                                 CciDataContext* userContext,
                                 CciMessage*  message,
                                 CciMessage*     localEnvironment,
                                 CciMessage* exceptionList,
                                 CciMessage*     environment,
                                 CciConnection*  connection);

Parámetros

userContext (entrada)
El valor que se ha pasado a la función cciRegisterUserExit.
message
Un manejador para el objeto del mensaje que se está propagando. El código de la salida de usuario no debe actualizar cabeceras de transporte o elementos de Propiedades en este árbol. La actualización del mensaje puede afectar al rendimiento, en particular si el mensaje de entrada no se verá cambiado en el flujo de mensajes.
localEnvironment
Un manejador para el objeto de entorno local que se está propagando.
exceptionList
Un manejador para el objeto de lista de excepción que se está propagando.
environment
Un manejador para el objeto de entorno para el flujo de mensajes actual.
connection
Un manejador para el objeto de conexión entre dos nodos. El manejador se puede utilizar, por ejemplo, en las llamadas a cciGetSourceNode, cciGetTargetNode, cciGetSourceTerminalName y cciGetTargetTerminalName. Este manejador sólo es válido mientras dura esta invocación de la función de rutina de usuario.

Valores de retorno

Ninguno.

Ejemplo

void myPropagatedMessageCallback(
                        CciMessage*  message,
                        CciMessage*    localEnvironment,
                        CciMessage* exceptionList,
                        CciMessage*    environment,
                        CciConnection* connection){
 

   int rc = CCI_SUCCESS;
   CciNode* targetNode = cciGetTargetNode(amp rc,
                                          connection);

 

   CciChar targetNodeName [initialStringBufferLength];
   targetNodeNameLength = cciGetNodeName(amp rc,
                                         targetNode,
                                         targetNodeName,
                                         initialStringBufferLength);
   /*debe comprobar ahora el código de retorno de los valores no previstos*/
   /*si el código de retorno es CCI_BUFFER_TOO_SMALL, cambie el tamaño y vuelva a intentarlo*/

}
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:30


Tema de referenciaTema de referencia | Versión 8.0.0.5 | as35930_