cniIsTerminalAttached

Verifica se um terminal está conectado a outro nó por um conector. Retorna um valor inteiro que especifica se o objeto de terminal especificado está conectado a um ou mais terminais em outros nós do fluxo de mensagens.

Utilize essa função para testar se uma mensagem pode ser propagada para um terminal; não é necessário chamar essa função antes de propagar uma mensagem com a função de utilitário cniPropagate. Utilize a funçãocniIsTerminalAttached para modificar o comportamento do nó quando um terminal não estiver conectado.

Sintaxe

int cniIsTerminalAttached(
    int*            returnCode,
    CciTerminal*  terminalObject);

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
terminalObject
O endereço do terminal de entrada ou de saída a ser verificado para um conector conectado (entrada). O endereço é retornado de cniCreateOutputTerminal.

Valores de Retorno

  • Se o terminal estiver conectado a outro nó por um conector, um valor de 1 é retornado.
  • Se o terminal não estiver conectado ou uma falha ocorreu, um valor de zero é retornado.
  • Se ocorrer uma falha, o valor do parâmetro returnCode indicará a razão do erro.

Exemplo

  if (terminalObject) {
        if (cniIsTerminalAttached(&rc, terminalObject)) {
            if (rc == CCI_SUCCESS) {
                retvalue = cniPropagate(
                                
&rc,
                                                             terminalObject,
                                localEnvironment, 
                                                             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

as07550_