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.

cpiSetElementNamespace

Verwenden Sie diese Funktion, um das Namespaceattribut für das angegebene Syntaxelement festzulegen.

Definiert in Typ Mitglied
CPI_VFT Optional iFpSetElementValue

Syntax

void             cpiSetElementNamespace(
		int*            returnCode,
		CciElement*     targetElement,
		const CciChar*  nameSpace);

Parameter

returnCode
Ein Nullzeiger-Eingabewert zeigt an, dass der benutzerdefinierte Knoten nicht für Fehler zuständig sein möchte. Alle während der Ausführung dieses Aufrufs ausgelösten Ausnahmebedingungen werden beim nächsten vorgeordneten Knoten im Nachrichtenfluss erneut ausgelöst. Wenn der Eingabewert nicht NULL ist, gibt die Ausgabe den Erfolgsstatus des Aufrufs an. Wenn während der Ausführung eine Ausnahmebedingung auftritt, wird *returnCode bei der Ausgabe auf CCI_EXCEPTION gesetzt. Rufen Sie CciGetLastExceptionData auf, um weitere Informationen zu der Ausnahmebedingung zu erhalten. (Eingabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
currentElement
Die Adresse des aktuellen Syntaxelements (Eingabe).
targetElement
Gibt die Adresse des Zielsyntaxelementobjekts an.
value
Gibt die Adresse einer mit null abgeschlossenen Zeichenfolge von CciChars an, die den Namespace-Wert darstellt. Eine leere Zeichenfolge ist ein gültiger Wert für den Namespace. Elemente werden standardmäßig im Namespace der leeren Zeichenfolge erstellt, deshalb ist der Aufruf bei der Angabe einer leeren Zeichenfolge als Namespace über diesen Aufruf nur effektiv, wenn das Element zuvor in einem anderen Namespace war und die erforderliche Wirkung darin besteht, den Namespace-Wert in eine leere Zeichenfolge zu ändern.

Rückgabewerte

Keine.

Beispiel

/* Attributwert in Brokerform 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);
          cpiSetElementName(&rc, newElement, data);
          cpiSetElementNamespace(&rc, newElement, data);
          if (pc->trace) {
            const char * mbData = mbString(data, pc->iCcsid);
            fprintf(pc->tracefile, "PLUGIN: Created new NAMESPACEVALUE 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);
          }
          /* Den in 'CciNString()' erstellten Speicherplatz 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:03


ReferenzthemaReferenzthema | Version 8.0.0.5 | as08185_