WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

cniPropagate

Use esta função para propagar uma mensagem para um objeto do terminal especificado. Se o terminal não estiver conectado a outro nó por um conector, a mensagem não será propagada e a função será ignorada.

Portanto, não é necessário verificar se o terminal está conectado antes de propagar a mensagem, a menos que deseje que o nó faça diferente neste cenário. Se necessário, é possível usar cniIsTerminalAttached para verificar se o terminal está conectado antes de chamar esta função.

Sintaxe

int cniPropagate(
  int*            returnCode,
  CciTerminal*  terminalObject,
  CciMessage* localEnvironment,
  CciMessage* exceptionList,
  CciMessage*        message);

Parâmetros

returnCode
O código de retorno da função (saída).
Os possíveis códigos de retorno são:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_TERMINAL_OBJECT
  • CCI_INV_MESSAGE_OBJECT
terminalObject
O endereço do terminal de saída que deve receber a mensagem (entrada). O endereço é retornado por cniCreateOutputTerminal.
localEnvironment
O endereço do objeto de ambiente local a ser enviado com a mensagem (entrada).

Esse objeto de mensagem é utilizado pelo nó de publicação/assinatura fornecido pelo intermediário.

Para compatibilidade com versões anteriores, você pode se referir a esse parâmetro como destinationList.

exceptionList
O endereço da lista de exceção para a mensagem (entrada).
message
O endereço do objeto de mensagem a ser enviado (entrada). Se a mensagem que está sendo enviada for o mesmo da mensagem de entrada, este endereço é o que é transmitido na função de implementação cniEvaluate.

Valores de Retorno

Se bem-sucedida, CCI_SUCCESS é retornado. Caso contrário, CCI_FAILURE é retornado e o parâmetro returnCode indica a razão do erro.

Exemplo

  if (terminalObject) {
    if (cniIsTerminalAttached(&rc, terminalObject)) {
      if (rc == CCI_SUCCESS) {
        cniPropagate(&rc, terminalObject, destinationList, exceptionList, message);
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:21


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | as07620_