cniElementName

Fornisce il valore dell'attributo name per l'elemento di sintassi specificato. Il nome dell'elemento di sintassi viene impostato in precedenza utilizzando cniSetElementName o cpiSetElementName.

Sintassi

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

Parametri

returnCode
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
L'indirizzo dell'oggetto elemento di sintassi di destinazione (input).
value
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 valore di attributo, returnCode è impostato su CCI_BUFFER_TOO_SMALL e viene restituito il numero di CciChars richiesti.
  • In caso di qualsiasi altro malfunzionamento, viene restituito CCI_FAILURE e returnCode indica il motivo dell'errore.
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as07890_