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).
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);

Conceitos relacionados
Nós Input definidos pelo usuário
Nós de Processamento de Mensagem Definidos pelo Usuário
Nós de Saída Definidos pelo Usuário

Tarefas relacionadas
Criando um Nó de Entrada em C
Criando um Nó de Processamento de Mensagem em C

Referências relacionadas
Funções Utilitárias de Nó em Linguagem C
cniCreateOutputTerminal
cniPropagate