cciInputMessageCallback

Esta é uma função que pode ser registrada como um retorno de chamada e é chamada sempre que uma mensagem é lida por um nó input e antes de a mensagem ser propagada no fluxo de mensagens. Ela é chamada para cada mensagem de entrada lida dentro do grupo de execução em que o retorno de chamada foi registrado, se o estado da saída de usuário é ativo. O retorno de chamada é registrado fornecendo um ponteiro para a função como o campo iFpInputMessageCallback da estrutura CCI_UE_VFT transmitida para cciRegisterUserExit.

Sintaxe

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

Parâmetros

userContext (entrada)
Este é o valor que foi transmitido para a função cciRegisterUserExit.
message
Esta é uma manipulação para o objeto de mensagens. O código de saída de usuário não deve atualizar essa árvore.
localEnvironment
Esta é uma manipulação para o objeto de ambiente local.
exceptionList
Esta é uma manipulação para o objeto de lista de exceções.
environment
Esta é uma manipulação para o objeto de ambiente para o fluxo de mensagens atual.
messageOrigin
Dependendo do tipo de nó input, a mensagem pode ser proveniente de um fluxo de bits (CCI_MESSAGE_ORIGIN_BITSTREAM) ou de uma árvore (CCI_MESSAGE_ORIGIN_TREE). A saída do usuário pode, portanto, acessar um deles, sem que o processamento seja iniciado pelo analisador. Por exemplo, no caso de MQInputNode, você pode acessar com segurança o fluxo de bits enquanto, no caso do nó input JMS, você pode acessar com segurança a árvore. O fluxo de bits pode ser acessado pela chamada de cniBufferPointer, cniBufferSize ou cniBufferByte. A árvore pode ser acessada pela chamada de cniRootElement e por meio da utilização das funções de navegação dos elemento comuns da sintaxe (por exemplo, cniFirstChild ).
Nota: Embora esse parâmetro instrua a saída do usuário para o que ele pode acessar com segurança sem que o processamento seja iniciado pelo analisador, é possível que o código de saída de usuário possa ignorar essa instrução e alterar efetivamente o tempo de análise.
inputNode
Esta é uma manipulação para o nó input que lê essa mensagem de entrada. Ela pode ser utilizada para fazer chamadas para funções como cciGetNodeName, cciGetNodeType e cniGetBrokerInfo.

Valores de Retorno

Nenhum.

Exemplo

void myInputMessageCallback(
                      CciDataContext* userContext,
                      CciMessage* message,
                      CciMessage* localEnvironment,
                      CciMessage* exceptionList,
                      CciMessage* environment,
                      CciMessageOrigin messageOrigin,
                      CciNode* inputNode){
…
…
}
Conceitos relacionados
Desenvolvendo Saídas do Usuário
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as35950_