cpiElementName

Finalidad

Obtiene el nombre del elemento de sintaxis de destino. El nombre de elemento de sintaxis se habrá establecido anteriormente 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 copiará el nombre de elemento (entrada).
length
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 tamaño del 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 cualquier otra anomalía, se devuelve CCI_FAILURE y returnCode indica la razón del error.

Ejemplo

cpiElementName(&rc;, element, (CciChar*)&elementName;, sizeof(elementName));
Conceptos relacionados
Analizadores definidos por el usuario
Extensiones definidas por el usuario
Tareas relacionadas
Creación de un analizador en C
Referencia relacionada
cpiElementType
Grupo cpiElementValue
cpiElementValueValue
Funciones de programa de utilidad de analizador en C
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as08430_