cniPropagate

Propaga uma mensagem para um objeto de 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 a ação que o nó executa seja diferente (nesse caso, você pode utilizar cniIsTerminalAttached para verificar se o terminal está conectado).

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, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:13:07

as07620_