cpiSetNameFromBuffer

Scopo

Imposta l'attributo del nome dell'elemento di sintassi di destinazione utilizzando i dati forniti nel buffer a cui punta il parametro name. La dimensione del nome viene specificata utilizzando il parametro length.

Sintassi

void cpiSetNameFromBuffer(
  int*      returnCode,
  CciElement*     targetElement,
  	const CciChar* name,
  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
targetElement
Specifica l'indirizzo dell'oggetto elemento di sintassi di destinazione (input).
name
L'indirizzo di un buffer contenente il nome (input).
length
La lunghezza della stringa di caratteri, espressa come il numero di caratteri CciChar specificati dal parametro del nome.

Valori di restituzione

Nessuno. Se si verifica un errore, il parametro returnCode indica il motivo dell'errore.

Esempio

/* Converte il valore di attributo nel formato del broker */
          data = CciNString((char *)startMarker, markedSize, pc->iCcsid);

/* Crea un nuovo elemento nome-valore per l'attributo */
          newElement = cpiCreateElement(&rc, parser);
          cpiSetElementType(&rc, newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
          cpiSetNameFromBuffer(&rc, newElement, data, length);
          if (pc->trace) {
            const char * mbData = mbString(data, pc->iCcsid);
            fprintf(pc->tracefile, "PLUGIN: Created new NAMEVALUE element; 
                    object=0x%x type=0x%x name=",
                    newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
            fprintf(pc->tracefile, "%s\n", mbData);
            fflush(pc->tracefile);
            free((void *)mbData);
          }
          /* Libera la memoria creata in CciNString() */
          free((void *)data);

          /* Aggiunge l'elemento */
          cpiAddAsLastChild(&rc, element, newElement);
Concetti correlati
Programmi di analisi definiti dall'utente
Estensioni definite dall'utente
Attività correlate
Creazione di un programma di analisi in C
Riferimenti correlati
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
as08540_