cniCreateInputTerminal

Erstellt ein Eingabeterminal bei einer Instanz eines Knotenobjekts; gibt die Adresse des erstellten Terminalobjekts aus. Das Terminalobjekt wird bei der Zerstörung des Eignerknotens vom Nachrichtenbroker mit zerstört.

Diese Funktion darf nur von innerhalb der Implementierungsfunktion cniCreateNodeContext aufgerufen werden.

Syntax

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

Parameter

returnCode
Der Rückkehrcode aus der Funktion (Ausgabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_NODE_OBJECT
  • CCI_INV_TERMINAL_NAME
nodeObject
Gibt die Adresse der Instanz des Knotenobjekts an, bei dem das Eingabeterminal erstellt werden soll (Eingabe). Die Adresse wird von cniCreateNodeContext ausgegeben.
name
Gibt einen Namen für das Terminal an, das erstellt wird (Eingabe).

Rückgabewerte

Bei Erfolg wird die Adresse des Knotenterminalobjekts zurückgegeben. Ansonsten wird ein Nullwert (CCI_NULL_ADDR) ausgegeben.

Beispiel

   entry->handle = cniCreateInputTerminal(
                                          &rc, 
                                          context->nodeObject, 
                                          (CciChar*)terminalName);
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as07530_