WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Grupo cpiElementValue

Este grupo de funciones recuperan el valor del elemento de sintaxis especificado.

Especifique la función adecuada de este grupo que coincida con el tipo de datos que se va a recuperar:

Sintaxis

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);

Parámetros

returnCode
Recibe el código de retorno de la función (salida).
Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
  • CCI_INV_DATA_BUFLEN
  • CCI_INV_BUFFER_TOO_SMALL
targetElement
Especifica la dirección del objeto de elemento de sintaxis de destino (entrada).
value
Dirección de un almacenamiento intermedio de salida en el que se almacena el valor del elemento de sintaxis (entrada). Sólo se utiliza en las llamadas de función pertinentes.
length
Longitud, en caracteres, del almacenamiento intermedio de salida especificado por el parámetro value (entrada). Sólo se utiliza en las llamadas de función pertinentes.

Valores de retorno

Se devuelve el valor del elemento.

En algunos casos, si el almacenamiento intermedio no es lo suficientemente grande como para recibir los datos, los datos no se graban en el almacenamiento intermedio. El tamaño del almacenamiento intermedio necesario se pasa como valor de retorno y returnCode se establece en CCI_BUFFER_TOO_SMALL. Por ejemplo, cpiElementCharacterValue y cpiElementDecimalValue utilizan esta técnica.

Si se produce un error, returnCode indica la razón del error.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

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

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:26


Tema de referenciaTema de referencia | Versión 8.0.0.5 | as08450_