cciInputMessageCallback

A função cciInputMessageCallback pode ser registrada como um retorno de chamada e é chamada toda vez que uma mensagem é lida por um nó de entrada e antes que a mensagem seja propagada para o fluxo de mensagens.

A função cciInputMessageCallback é chamada para cada mensagem de entrada que é lida no grupo de execução em que o retorno de chamada é registrado, se o estado de saída de usuário estiver 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)
O valor transmitido para a função cciRegisterUserExit.
message
Um identificador para o objeto de mensagem. O código de saída de usuário não deve atualizar esta árvore.
localEnvironment
Um identificador para o objeto de ambiente local.
exceptionList
Um identificador para o objeto da lista de exceções.
environment
Um identificador para o objeto de ambiente para o fluxo de mensagens atual.
messageOrigin
Dependendo do tipo de nó de entrada, a mensagem pode ter sido originada de um fluxo de bits (CCI_MESSAGE_ORIGIN_BITSTREAM) ou de uma árvore (CCI_MESSAGE_ORIGIN_TREE). A saída de usuário pode acessar uma destas origens sem causar processamento pelo analisador. Por exemplo, no caso do nó MQInput, você pode acessar o fluxo de bits de maneira segura, enquanto no caso do nó JMSInput, você pode acessar a árvore de maneira segura. Você pode acessar o fluxo de bits chamando cniBufferPointer, cniBufferSize ou cniBufferByte. Você pode acessar a árvore chamando cniRootElement e utilizando as funções de navegação do elemento da sintaxe comuns (por exemplo, cniFirstChild ). Embora este parâmetro informe a saída de usuário sobre o que ela pode acessar de maneira segura sem causar processamento pelo analisador, o código de saída de usuário poderá ignorar esta recomendação e alterar efetivamente o tempo de análise.
inputNode
Um identificador para o nó de entrada que lê esta mensagem de entrada. O identificador pode ser utilizado 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
Saídas de usuário
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:13:13

as35950_