cniCreateInputTerminal

Diese Funktion erstellt ein Eingabeterminal auf einer Instanz eines Knotenobjekts und gibt die Adresse des Terminalobjekts zurück, das erstellt wurde. Das Terminalobjekt wird vom Nachrichtenbroker 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* 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, auf dem das Eingabeterminal erstellt werden soll (Eingabe). Die Adresse wird von cniCreateNodeContext zurückgegeben.
name
Gibt einen Namen für das Terminal an, 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 = cniCreateInputTerminal(
                                          &rc, 
                                          context->nodeObject, 
                                          (CciChar*)terminalName);
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
as07530_