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 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 Kennung wird an die Funktion cniCreateNodeContext übergeben.
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 | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:29:56

as07530_