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.

cpiElementNameSpace

Diese Funktion ruft den Wert des Attributs namespace für das angegebene Syntaxelement ab.

Definiert in Typ Mitglied
CPI_VFT Optional iFpElementValue

Syntax

CciSize cpiElementNamespace(
   int*           returnCode,
   CciElement*    targetElement,
   const CciChar* value,
   CciSize        length);

Parameter

returnCode
Die Eingabe eines Nullzeigers bedeutet, 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 die Eingabe 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. Sie können CciGetLastExceptionData aufrufen, um weitere Informationen zu der Ausnahmebedingung zu erhalten. Wenn der Aufrufende nicht genügend Speicher für den Namespacewert zugeordnet hat, wird als Wert für '*returncode' CCI_BUFFER_TOO_SMALL festgelegt.
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
  • CCI_INV_DATA_BUFLEN
  • CCI_INV_BUFFER_TOO_SMALL
targetElement
Gibt die Adresse des Zielsyntaxelementobjekts an.
value
Gibt die Adresse eines Puffers an, in den der Namespacewert des Elements kopiert wird. Eine Zeichenfolge (einschließlich eines Nullabschlusszeichens), die den Namespace-Wert darstellen, wird in diesen Puffer kopiert. Der Puffer muss ein Teil des Speichers sein, der zuvor vom Aufrufenden zugeordnet wurde.
length
Die Länge des Puffers (in Zeichen (ChiChars)), der durch den Parameter 'value' angegeben wird.

Rückgabewerte

Bei erfolgreicher Ausführung wird die Anzahl der in den Puffer kopierten Zeichen (CciChars) zurückgegeben.

Wenn der Puffer für den Attributwert 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

elementNamespace=(CciChar*)malloc(sizeof(CciChar) * elementNamespaceLength);
    elementNamespaceLength = cpiElementNamespace(&rc;,
                        element,
                        elementNamespace,
                        elementNamespaceLength);
    
    if (rc==CCI_BUFFER_TOO_SMALL){
      free(elementNamespace);
      elementNamespace=(CciChar*)malloc(sizeof(CciChar) * elementNamespaceLength);
      elementNamespaceLength = cpiElementNamespace(&rc;,
                        element,
                        elementNamespace,
                        elementNamespaceLength);
    }
    checkRC(rc);
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 | as08105_