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.

cniElementValue-Gruppe

Verwenden Sie eine oder mehrere der Funktionen in dieser Gruppe, um den Wert des angegebenen Syntaxelements abzurufen.

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

Syntax

CciSize cniElementBitArrayValue(
  int*           returnCode,
  CciElement*    targetElement,
  const struct   CciBitArray* value);
CciBool cniElementBooleanValue(
  int*           returnCode,
  CciElement*    targetElement);
CciSize cniElementByteArrayValue(
  int*           returnCode,
  CciElement*    targetElement,
  const struct   CciByteArray* value);
CciSize cniElementCharacterValue(
  int*           returnCode,
  CciElement*    targetElement,
  const CciChar* value,
  CciSize        length);
struct CciDate cniElementDateValue(
  int*           returnCode,
  CciElement*    targetElement);
CciSize cniElementDecimalValue(
  int*           returnCode,
  CciElement*    targetElement,
  const CciChar* value,
  CciSize        length);
struct CciTimestamp cniElementGmtTimestampValue(
  int*           returnCode,
  CciElement*    targetElement);
struct CciTime cniElementGmtTimeValue(
  int*           returnCode,
  CciElement*    targetElement);
CciInt cniElementIntegerValue(
  int*           returnCode,
  CciElement*    targetElement);
CciReal cniElementRealValue(
  int*           returnCode,
  CciElement*    targetElement);
struct CciTimestamp cniElementTimestampValue(
  int*           returnCode,
  CciElement*    targetElement);
struct CciTime cniElementTimeValue(
  int*           returnCode,
  CciElement*    targetElement);

Parameter

returnCode
Der 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
Die Adresse des Zielsyntaxelementobjekts (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

  • Bei Erfolg wird der Wert des Zielelements ausgegeben.
  • Wenn die Größe der Daten eines Elements variieren kann, wird die korrekte Datengröße ausgegeben.
  • Ist die angegebene Länge zu klein, wird der Fehlercode auf CCI_BUFFER_TOO_SMALL gesetzt.
  • Wenn ein Fehler auftritt, gibt der Parameter returnCode die Fehlerursache an.

Beispiel

 numberOfChars     = cniElementCharacterValue(
		 		 		 		 &rc, firstChild, (CciChar*)&elementValue, sizeof(elementValue)
		 		 );

if (rc==CCI_BUFFER_TOO_SMALL) {
    free(elementValue);
    elementValue      = (CciChar*)malloc(numberOfChars * sizeof(CciChar));
    numberOfChars     = cniElementCharacterValue(
                  &rc, firstChild, (CciChar*)&elementValue, sizeof(elementValue));
  }
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:22:02


ReferenzthemaReferenzthema | Version 8.0.0.5 | as07910_