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 von 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 Adresse wird von cniCreateNodeContext ausgegeben.
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 | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as07540_