cniIsTerminalAttached

Use esta função para verificar 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, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-07-17 10:04:51


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.1 | as07550_