cniCreateOutputTerminal

Diese Funktion erstellt ein Ausgabeterminal auf einer Instanz eines Knotenobjekts und gibt die Adresse des Terminalobjekts zurück, das erstellt wurde. Das Terminalobjekt wird gelöscht, wenn der Knoten gelöscht wird, zu dem es gehö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_EXCEPTION
  • CCI_INV_NODE_OBJECT
  • CCI_INV_TERMINAL_NAME
nodeObject
Die Adresse der Instanz des Knotenobjekts, auf dem das Ausgabeterminal erstellt werden soll (Eingabe). Die Adresse wird von cniCreateNodeContext zurückgegeben.
name
Der Name des Terminals, das erstellt wird (Eingabe).

Rückgabewerte

Bei erfolgreicher Ausführung wird die Adresse des Knotenterminalobjekts zurückgegeben. Andernfalls wird der Wert null (CCI_NULL_ADDR) zurückgegeben.

Beispiel

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