cciInputMessageCallback

La función se puede registrar como una devolución de llamada y se invoca cada vez que un nodo de entrada lee un mensaje y antes de que el mensaje se propague en sentido descendente por el flujo de mensajes.

La función cciInputMessageCallback se invoca para cada mensaje de entrada que se lee 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 iFpInputMessageCallback de la estructura CCI_UE_VFT que se ha pasado a cciRegisterUserExit.

Sintaxis

typedef void (*cciInputMessageCallback)     ( 
                                 CciDataContext*  userContext,
                                 CciMessage*  message,
                                 CciMessage*      localEnvironment,
                                 CciMessage* exceptionList,
                                 CciMessage*      environment,
                                 CciMessageOrigin messageOrigin,
                                 CciNode*         inputNode);

Parámetros

userContext (entrada)
El valor que se ha pasado a la función cciRegisterUserExit.
message
Un manejador para el objeto del mensaje. El código de la salida de usuario no debe actualizar este árbol.
localEnvironment
Un manejador para el objeto de entorno local.
exceptionList
Un manejador para el objeto de lista de excepción.
environment
Un manejador para el objeto de entorno del flujo de mensajes actual.
messageOrigin
En función del tipo de nodo de entrada, es posible que el mensaje se origine a partir de una corriente de bits (CCI_MESSAGE_ORIGIN_BITSTREAM) o de un árbol (CCI_MESSAGE_ORIGIN_TREE). La salida de usuario puede acceder a una de estas fuentes sin activar procesos del analizador. Por ejemplo, en el caso del nodo MQInput, puede acceder a la corriente de bits, mientras que en el caso del nodo JMSInput, puede acceder al árbol sin problemas. Puede acceder a la corriente de bits invocando cniBufferPointer, cniBufferSize o cniBufferByte. Puede acceder al árbol invocando cniRootElement y utilizando las funciones de navegación habituales de los elementos de sintaxis (por ejemplo, cniFirstChild ). Aunque este parámetro indica a la salida de usuario que puede acceder con seguridad sin activar procesos del analizador, es posible que el código de salida de usuario ignore esta recomendación y altere de hecho la temporización del analizador.
inputNode
Un manejador para el nodo de entrada que lee este mensaje de entrada. El manejador se puede utilizar para efectuar llamadas a funciones como cciGetNodeName, cciGetNodeType y cniGetBrokerInfo.

Valores de retorno

Ninguno.

Ejemplo

void myInputMessageCallback(
                      CciDataContext*  userContext,
                      CciMessage*  message,
                      CciMessage*      localEnvironment,
                      CciMessage* exceptionList,
                      CciMessage*      environment,
                      CciMessageOrigin messageOrigin,
                      CciNode*         inputNode){
…
…
}
Conceptos relacionados
Salidas de usuario
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última actualización : 2009-02-16 13:56:22

as35950_