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);
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as07550_