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.

cpiSetElementName

Diese Funktion legt den Namen des angegebenen Syntaxelements fest.

Syntax

void cpiSetElementName(
  int*            returnCode,
  CciElement*     targetElement,
  const CciChar*  name);

Parameter

returnCode
Empfängt den Rückkehrcode von der Funktion (Ausgabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
targetElement
Gibt die Adresse des Zielsyntaxelementobjekts an (Eingabe).
name
Der Name, der im Zielelement festgelegt werden muss (Eingabe).

Rückgabewerte

Keine. Wenn ein Fehler auftritt, gibt returnCode den Grund für den Fehler an.

Beispiel

Das folgende Beispiel stammt aus der Musterparserdatei BipSampPluginParser.c:

/* Konvertieren Sie den Attributwert ins Brokerformat */
          data = CciNString((char *)startMarker, markedSize, pc->iCcsid);

/* Erstellen Sie ein neues Namenswertelement für das Attribut */
          newElement = cpiCreateElement(&rc, parser);
          cpiSetElementType(&rc, newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
          cpiSetElementName(&rc, newElement, data);
          if (pc->trace) {
            const char * mbData = mbString(data, pc->iCcsid);
            fprintf(pc->tracefile, "PLUGIN: Created new NAMEVALUE element; 
                    object=0x%x type=0x%x name=",
                    newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
            fprintf(pc->tracefile, "%s\n", mbData);
            fflush(pc->tracefile);
            free((void *)mbData);
          }
          /* Geben Sie den in 'CciNString()' erstellten Speicherplatz frei */
          free((void *)data);

          /* Fügen Sie das Element hinzu */
          cpiAddAsLastChild(&rc, element, newElement);
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

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

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


ReferenzthemaReferenzthema | Version 8.0.0.5 | as08500_