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. Pode ser utilizada para testar se uma mensagem pode ser propagada a um terminal. Entretanto, não é necessário chamar essa função antes de propagar uma mensagem com a função utilitária cniPropagate. Utilizando a função cniIsTerminalAttached, um nó pode modificar seu comportamento 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 uma falha ocorreu, o valor do parâmetro returnCode indica a razão do erro.

Exemplo

if (terminalObject) {
    if (cniIsTerminalAttached(&rc, terminalObject)) {
      if (rc == CCI_SUCCESS) {
        retvalue = cniPropagate(

&rc,
                             terminalObject,
                             destinationList,
                             exceptionList,
                                message);
Notices | Trademarks | Downloads | Library | Support | Feedback
Copyright IBM Corporation 1999, 2006 Last updated: 5월 25, 2006
as07550_