cniIsTerminalAttached

Verifica se un terminale è collegato ad un altro nodo mediante un connettore. Restituisce un valore intero che specifica se l'oggetto terminale indicato è collegato ad uno o più terminali su altri nodi del flusso di messaggi. Mediante questa funzione è possibile verificare se un messaggio può essere inviato ad un terminale. Tuttavia, non è necessario richiamare questa funzione prima dell'invio di un messaggio con la funzione di utilità cniPropagate. Mediante l'uso della funzione cniIsTerminalAttached, un nodo può modificare il relativo funzionamento quando un terminale non è collegato.

Sintassi

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

Parametri

returnCode
Il codice di ritorno dalla funzione (output).
I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_TERMINAL_OBJECT
terminalObject
L'indirizzo del terminale di input o output per il quale verificare la presenza di un connettore collegato (input). L'indirizzo viene restituito da cniCreateOutputTerminal.

Valori di restituzione

  • Se il terminale è collegato ad un altro nodo mediante un connettore, viene restituito il valore 1.
  • Se il terminale non è collegato o se si è verificato un errore, viene restituito il valore zero.
  • Se si è verificato un errore, il valore del parametro returnCode indica il motivo dell'errore.

Esempio

  if (terminalObject) {
    if (cniIsTerminalAttached(&rc, terminalObject)) {
      if (rc == CCI_SUCCESS) {
        retvalue = cniPropagate(
                                &rc, 
                                terminalObject, 
                                destinationList, 
                                exceptionList, 
                                message);
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as07550_