cniElementName

Obtiene el valor del atributo nombre para el elemento de sintaxis especificado. El nombre de elemento de sintaxis se habrá establecido anteriormente 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).
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
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 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 valor del atributo, returnCode se establece en CCI_BUFFER_TOO_SMALL y se devuelve el número de CciChars necesarios.
  • Para cualquier otra anomalía, se devuelve CCI_FAILURE y returnCode indica la razón del error.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as07890_