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

cpiElementName

Esta función obtiene el nombre del elemento de sintaxis de destino. El nombre del elemento de sintaxis debe establecerse previamente utilizando cniSetElementName o cpiSetElementName.

Sintaxis

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

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
Especifica la dirección de un almacenamiento intermedio en el que se copia el nombre de elemento (entrada).
length
La longitud, en caracteres, especificada por el parámetro value (entrada).

Valores de retorno

Si la ejecución se realiza satisfactoriamente, el nombre de elemento se copia en el almacenamiento intermedio proporcionado y se devuelve el número de caracteres CciChar copiados. Si el almacenamiento intermedio no es suficientemente grande para contener el nombre de elemento, returnCode se establece en CCI_BUFFER_TOO_SMALL y se devuelve el número de caracteres necesarios. Para todos los demás errores, se devuelve CCI_FAILURE y returnCode indica la razón del error.

Ejemplo

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