cpiElementName

Scopo

Fornisce il nome dell'elemento di sintassi di destinazione. Il nome dell'elemento di sintassi viene impostato in precedenza utilizzando cniSetElementName o cpiSetElementName.

Sintassi

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

Parametri

returnCode
Riceve il codice di ritorno dalla funzione (output).
I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
  • CCI_INV_DATA_BUFLEN
  • CCI_INV_BUFFER_TOO_SMALL
targetElement
Specifica l'indirizzo dell'oggetto elemento di sintassi di destinazione (input).
value
Specifica l'indirizzo di un buffer in cui viene copiato il nome dell'elemento (input).
length
La lunghezza, in caratteri, specificata nel parametro value (input).

Valori di restituzione

Se ha esito positivo, il nome di elemento viene copiato nel buffer fornito e viene restituito il numero di caratteri CciChar copiati. Se il buffer non è grande a sufficienza per contenere il nome di elemento, returnCode è impostato su CCI_BUFFER_TOO_SMALL e viene restituito il numero di caratteri richiesti. In caso di qualsiasi altro malfunzionamento, viene restituito CCI_FAILURE e returnCode indica il motivo dell'errore.

Esempio

cpiElementName(&rc;, element, (CciChar*)&elementName;, sizeof(elementName));
Concetti correlati
Programmi di analisi definiti dall'utente
Estensioni definite dall'utente
Attività correlate
Creazione di un programma di analisi in C
Riferimenti correlati
cpiElementType
Gruppo cpiElementValue
cpiElementValueValue
Funzioni di utilità del programma di analisi in C
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as08430_