cniCreateOutputTerminal

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

Diese Funktion darf nur innerhalb der Implementierungsfunktion cniCreateNodeContext aufgerufen werden.

Syntax

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

Parameter

returnCode
Der Rückkehrcode aus der Funktion (Ausgabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_FAILURE
  • CCI_EXCEPTION
  • CCI_INV_NODE_OBJECT
  • CCI_INV_TERMINAL_NAME
nodeObject
Die Adresse der Instanz des Knotenobjekts, bei dem das Ausgabeterminal erstellt werden soll (Eingabe). Die Kennung wird an die Funktion cniCreateNodeContext übergeben.
name
Der Name des Terminals, 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 = cniCreateOutputTerminal(
                                           &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

as07540_