cniElementName

Esta función obtiene el valor del atributo nombre para el elemento de sintaxis especificado. El nombre del elemento de sintaxis se habrá establecido previamente utilizando cniSetElementName o cpiSetElementName.

Sintaxis

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

Parámetros

returnCode
Código de retorno de la función (salida).
targetElement
Dirección del objeto de elemento de sintaxis de destino (entrada).
value
Dirección de un almacenamiento intermedio en el que se copia el nombre del 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 copiado.
  • 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 bytes necesarios.
  • Si se producen otras anomalías, se devuelve CCI_FAILURE, y returnCode indica la causa del error.

Conceptos relacionados
Nodos de proceso de mensajes definidos por el usuario
Nodos de salida definidos por el usuario

Tareas relacionadas
Creación de un nodo de proceso de mensajes en C

Referencia relacionada
Funciones de programa de utilidad de nodo de lenguaje C
cniElementAsBitstream
cniElementNamespace
cniElementType
Grupo cniElementValue
cniElementValueState
cniElementValueType
cniElementValueValue
cniSetElementName
cpiSetElementName