cpiElementName

Finalidad

Esta función obtiene el nombre del elemento de sintaxis de destino. El nombre del elemento de sintaxis se habrá establecido 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).
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 mediante al parámetro value (entrada).

Valores de retorno

Si la función se ejecuta correctamente, el nombre de elemento se copia en el almacenamiento intermedio suministrado, y se devuelve el número de caracteres CciChar copiados. Si el almacenamiento intermedio no es lo suficientemente grande como para contener el nombre de elemento, returnCode se establece en CCI_BUFFER_TOO_SMALL, y se devuelve el número de caracteres necesarios. Si se producen otras anomalías, se devuelve CCI_FAILURE, y returnCode indica la causa 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