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.

cpiSetNameFromBuffer

Diese Funktion legt das Namensattribut des Zielsyntaxelements fest, indem die im Puffer gelieferten Daten verwendet werden, auf die der Parameter name zeigt. Die Größe des Namens wird mithilfe des Parameters Länge angegeben.

Syntax

void cpiSetNameFromBuffer(
  int*            returnCode,
  CciElement*     targetElement,
  const CciChar*  name,
  CciSize         length);

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
  • CCI_INV_DATA_BUFLEN
targetElement
Gibt die Adresse des Zielsyntaxelementobjekts an (Eingabe).
name
Die Adresse eines Puffers, der den Namen enthält (Eingabe).
length
Die Länge der durch den Namensparameter angegebenen Zeichenfolge, dargestellt als Anzahl von CciChar-Zeichen.

Rückgabewerte

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

Beispiel

/* Attributwert in Brokerformat konvertieren */
          data = CciNString((char *)startMarker, markedSize, pc->iCcsid);

/* Neues Name/Wert-Element für das Attribut erstellen */
          newElement = cpiCreateElement(&rc, parser);
          cpiSetElementType(&rc, newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
          cpiSetNameFromBuffer(&rc, newElement, data, length);
          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);
          }
          /* In CciNString() erstellten Speicher freigeben */
          free((void *)data);

          /* Element hinzufügen */
          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 | as08540_