cniCreateInputTerminal

Crea un terminale di input su un'istanza di un oggetto nodo, restituendo l'indirizzo dell'oggetto terminale creato. L'oggetto terminale viene eliminato dal broker di messaggi quando viene eliminato il relativo nodo di proprietà.

Questa funzione deve essere richiamata solo dall'interno della funzione di implementazione cniCreateNodeContext.

Sintassi

CciTerminal* cniCreateInputTerminal(
  int*      returnCode,
  CciNode*  nodeObject,
  CciChar*  name);

Parametri

returnCode
Il codice di ritorno dalla funzione (output).
I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_NODE_OBJECT
  • CCI_INV_TERMINAL_NAME
nodeObject
Specifica l'indirizzo dell'istanza dell'oggetto nodo su cui deve essere creato il terminale di input (input). L'indirizzo viene restituito da cniCreateNodeContext.
name
Specifica un nome per il terminale creato (input).

Valori di restituzione

Se ha esito positivo, viene restituito l'indirizzo dell'oggetto terminale del nodo. Altrimenti, viene restituito un valore zero (CCI_NULL_ADDR).

Esempio

   entry->handle = cniCreateInputTerminal(
                                          &rc, 
                                          context->nodeObject, 
                                          (CciChar*)terminalName);
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as07530_