cpiSetElementNamespace

Scopo

Imposta l'attributo "namespace" per l'elemento di sintassi specificato.

Definito in Tipo Membro
CPI_VFT Facoltativo iFpSetElementValue

Sintassi

void             cpiSetElementNamespace(
int*      returnCode,
CciElement*     targetElement,
		const CciChar*  nameSpace);

Parametri

returnCode
Un input del puntatore NULL indica che il nodo definito dall'utente non intende gestire gli errori. Eventuali eccezioni generate durante l'esecuzione di questa chiamata, verranno generate nuovamente nel nodo successivo a monte del flusso. Se l'input è diverso da NULL, l'output indicherà lo stato positivo della chiamata. Se durante l'esecuzione si verifica un'eccezione, *returnCode verrà impostato su CCI_EXCEPTION nell'output. Una chiamata a CciGetLastExceptionData fornirà informazioni dettagliate sull'eccezione (input).
I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
currentElement
L'indirizzo dell'elemento di sintassi attuale (input).
targetElement
Specifica l'indirizzo dell'oggetto elemento di sintassi di destinazione.
value
Specifica l'indirizzo di una stringa terminata con valore nullo di CciChars che rappresenta il valore di spazio dei nomi. Una stringa vuota è un valore valido per spazio dei nomi. Come impostazione predefinita, gli elementi vengono creati nello spazio dei nomi della stringa vuota, cosicché, mediante questa API è possibile specificare una stringa vuota come spazio dei nomi, ma ciò ha effetto solo se l'elemento era in precedenza in un altro spazio dei nomi e si desidera modificare il valore di spazio dei nomi in una stringa vuota.

Valori di restituzione

Nessuno.

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);
          cpiSetElementName(&rc, newElement, data);
          cpiSetElementNamespace(&rc, newElement, data);
          if (pc->trace) {
            const char * mbData = mbString(data, pc->iCcsid);
            fprintf(pc->tracefile, "PLUGIN: Created new NAMESPACEVALUE 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
cpiElementNameSpace
Funzioni di implementazione del programma di analisi in C
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as08185_