cniDefineNodeClass

Diese Funktion definiert eine Knotenklasse, die durch den Parameter name angegeben wird und von der als Parameter factoryObject angegebenen Knoten-Factory unterstützt wird. Diese Funktion wird während der Ausführung von bipGetMessageFlowNodeFactory vom Knoten aufgerufen, wenn die LIL geladen wird.

Wenn sowohl cniGetAttribute als auch cniGetAttribute2 oder cniGetAttributeName und cniGetAttributeName2 implementiert werden, schlägt cniDefineNodeClass mit with CCI_INV_IMPL_FUNCTION fehl.

Syntax

void cniDefineNodeClass(
int*         returnCode,
CciFactory*  factoryObject,
CciChar*     name,
CNI_VFT*     functbl);

Parameter

returnCode
Der Rückkehrcode aus der Funktion (Ausgabe). Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_FACTORY_OBJECT
  • CCI_INV_NODE_NAME
  • CCI_INV_OBJECT_NAME
  • CCI_INV_VFTP
  • CCI_MISSING_IMPL_FUNCTION
  • CCI_NAME_EXISTS
factoryObject
Die Adresse des Factory-Objekts, das den angegebenen Knoten unterstützt. Die Adresse wird von cniCreateNodeFactory zurückgegeben (Eingabe).
name
Der Name des Knotens, der definiert werden soll. Der Name des Knotens muss mit den Zeichen Node enden (Eingabe).
functbl
Die Adresse der Struktur CNI_VFT, die Zeiger auf die Knotenimplementierungsfunktionen enthält (Eingabe). Im Folgenden finden Sie ein Beispiel einer Funktionstabelle:
vftable.iFpCreateNodeContext = _Transform_createNodeContext;
vftable.iFpDeleteNodeContext = _deleteNodeContext;
vftable.iFpGetAttributeName2 = _getAttributeName2;
vftable.iFpSetAttribute      = _setAttribute;
vftable.iFpGetAttribute2     = _getAttribute2;
vftable.iFpEvaluate          = _Transform_evaluate; /* if not an input node */ 
vftable.iFRun                = _run                 /* if an input node */

Normalerweise definieren Sie nur einen der letzten zwei Einträge, d. h., Sie definieren vftable.iFpEvaluate = _Transform_evaluate; für einen Nachrichtenverarbeitungsknoten oder vftable.iFpRun = _run; für einen Empfangsknoten.

Rückgabewerte

Keine. Wenn ein Fehler auftritt, gibt der Parameter returnCode die Fehlerursache an.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
as07510_