WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

cciGetNodeName

Diese Funktion gibt den Namen des angegebenen Knotens zurück.

Der Name wird intern durch das WebSphere Message Broker Toolkit zugeordnet und ist im Nachrichtenfluss eindeutig. Die Bezeichnung, die dem Knoten durch den Entwickler des Nachrichtenflusses im Nachrichtenflusseditor zugeordnet wurde, kann durch das Aufrufen von cciGetNodeAttribute zum Lesen des Attributs für die Bezeichnung abgerufen werden.

Syntax

CciSize  getNodeName (int*                    returnCode,
                                        CciNode*          node,
                                        CciChar*          value,
                                        CciSize           length);

Parameter

returnCode (Ausgabe)
Empfängt den Rückkehrcode von der Funktion (Ausgabe)
  • CCI_INV_BUFFER_TOO_SMALL

    Der bereitgestellte Puffer war nicht groß genug für den Wert des Knotennamens.

node (Eingabe)
Dies ist eine Kennung für einen Knoten.
value (Ausgabe)
Adresse eines Puffers, der vom Aufrufenden für den Wert des Knotennamens reserviert wurde.
length
Die Länge (in 'CciChars') des Puffers, der vom Aufrufenden reserviert wurde.

Rückgabewerte

  • Bei erfolgreicher Ausführung wird der Knotenname in den angegebenen Puffer kopiert, und die Anzahl der kopierten Zeichen des Typs CciChar wird zurückgegeben.
  • Wenn der Puffer für den Knotennamen nicht groß genug ist, wird als Wert für returnCode CCI_BUFFER_TOO_SMALL festgelegt, und die erforderliche Anzahl der Zeichen (CciChars) wird zurückgegeben.

Beispiel

void myPropagatedMessageCallback(
                        CciMessage*        message,
                        CciMessage*    localEnvironment,
                        CciMessage* exceptionList,
                        CciMessage*    environment,
                        CciConnection* connection){
 
	 int          rc = CCI_SUCCESS;
   CciNode* targetNode = cciGetTargetNode(&rc,
                                          connection);

 

   CciChar targetNodeName [initialStringBufferLength];
   targetNodeNameLength = cciGetNodeName(&rc,
                                         targetNode,
                                         targetNodeName,
                                         initialStringBufferLength);
   /*rc sollte nun auf unerwartete Werte überprüft werden*/
   /*wenn rc 'CCI_BUFFER_TOO_SMALL' ist, ändern Sie die Größe versuchen Sie es erneut*/

}  
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:22:09


ReferenzthemaReferenzthema | Version 8.0.0.5 | as35990_