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.

cpiElementValue-Gruppe

Diese Funktionsgruppe ruft den Wert des angegebenen Syntaxelements ab.

Geben Sie die entsprechende Funktion aus dieser Gruppe an, die dem Datentyp entspricht, der abgerufen werden soll:

Syntax

CciSize cpiElementBitArrayValue(
  int*         returnCode,
  CciElement*  targetElement,
  const struct CciBitArray* value);
CciBool cpiElementBooleanValue(
  int*         returnCode,
  CciElement*  targetElement);
CciSize cpiElementByteArrayValue(
  int*         returnCode,
  CciElement*  targetElement,
  const struct CciByteArray* value);
CciSize cpiElementCharacterValue(
  int*            returnCode,
  CciElement*     targetElement,
  const CciChar*  value,
  CciSize         length);
struct CciDate cpiElementDateValue(
  int*         returnCode,
  CciElement*  targetElement);
CciSize cpiElementDecimalValue(
  int*            returnCode,
  CciElement*     targetElement,
  const CciChar*  value,
  CciSize         length);
struct CciTimestamp cpiElementGmtTimestampValue(
  int*         returnCode,
  CciElement*  targetElement);
struct CciTime cpiElementGmtTimeValue(
  int*         returnCode,
  CciElement*  targetElement);
CciInt cpiElementIntegerValue(
  int*         returnCode,
  CciElement*  targetElement);
CciReal cpiElementRealValue(
  int*         returnCode,
  CciElement*  targetElement);
struct CciTimestamp cpiElementTimestampValue(
  int*         returnCode,
  CciElement*  targetElement);
struct CciTime cpiElementTimeValue(
  int*         returnCode,
  CciElement*  targetElement);

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
Die Adresse eines Ausgabepuffers, in den der Wert des Syntaxelements gespeichert wird (Eingabe). Nur unter relevanten Funktionsaufrufen verwendet.
length
Die Länge des Ausgabepuffers (in Zeichen), die vom Parameter value angegeben wird (Eingabe). Nur unter relevanten Funktionsaufrufen verwendet.

Rückgabewerte

Der Wert des Elements wird zurückgegeben.

In einigen Fällen, wenn der Puffer nicht groß genug ist, um die Daten zu empfangen, werden die Daten nicht in den Puffer geschrieben. Die Größe des erforderlichen Puffers wird als Rückgabewert übergeben, und der Rückkehrcode wird auf CCI_BUFFER_TOO_SMALL gesetzt. Dieses Verfahren wird beispielsweise von cpiElementCharacterValue oder cpiElementDecimalValue verwendet.

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

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 | as08450_