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.

cpiElementName

Diese Funktion ruft den Namen des Zielsyntaxelements ab. Der Name des Syntaxelements muss zuvor mit cniSetElementName oder cpiSetElementName festgelegt werden.

Syntax

Ccisize           cpiElementName(
  int*            returnCode,
  CciElement*     targetElement,
  const CciChar*  value,
  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
  • CCI_INV_BUFFER_TOO_SMALL
targetElement
Gibt die Adresse des Zielsyntaxelementobjekts an (Eingabe).
value
Gibt die Adresse eines Puffers an, in den der Elementname kopiert wird (Eingabe).
length
Die Länge (in Zeichen), die vom Parameter value angegeben wird (Eingabe).

Rückgabewerte

Bei Erfolg wird der Elementname in den bereitgestellten Puffer kopiert und die Zahl der kopierten CciChar-Zeichen ausgegeben. Wenn der Puffer für den Elementnamen nicht groß genug ist, wird der Rückkehrcode auf CCI_BUFFER_TOO_SMALL gesetzt, und die Anzahl der erforderlichen Zeichen wird zurückgegeben. Bei allen anderen Fehlern wird CCI_FAILURE zurückgegeben und returnCode gibt den Grund für den Fehler an.

Beispiel

cpiElementName(&rc;, element, (CciChar*)&elementName;, sizeof(elementName));
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 | as08430_