cpiSetElementNamespace

Zweck

Diese Funktion legt das Attribut 'namespace' für das angegebene Syntaxelement fest.

Definiert in Typ Mitglied
CPI_VFT Optional iFpSetElementValue

Syntax

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

Parameter

returnCode
Die Eingabe eines Nullzeigers bedeutet, dass der benutzerdefinierte Knoten nicht für Fehler zuständig sein möchte. Alle Ausnahmebedingungen, die bei der Ausführung dieses Aufrufs ausgegeben werden, werden beim nächsten vorgeschalteten Knoten im Nachrichtenfluss erneut ausgegeben. Wenn die Eingabe nicht NULL ist, gibt die Ausgabe den Erfolgsstatus des Aufrufs an. Wenn bei der Ausführung eine Ausnahmebedingung auftritt, wird als Wert für '*returnCode' bei der Ausgabe CCI_EXCEPTION festgelegt. Rufen Sie 'CciGetLastExceptionData' auf, um weitere Informationen zu der Ausnahmebedingung zu erhalten. (Eingabe). Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
currentElement
Die Adresse des aktuellen Syntaxelements (Eingabe).
targetElement
Gibt die Adresse des Zielsyntaxelementobjekts an.
value
Gibt die Adresse einer Zeichenfolge mit Null am Ende (CciChars) an, die den Namespacewert darstellt. Eine leere Zeichenfolge ist ein gültiger Wert für den Namespace. Standardmäßig werden Elemente in dem Namespace erstellt, der eine leere Zeichenfolge ist. Wenn Sie über diese API eine leere Zeichenfolge als Namespace angeben, hat dies nur dann eine Wirkung, wenn sich das Element zuvor in einem anderen Namespace befand und Sie den Wert für den Namespace in eine leere Zeichenfolge ändern möchten.

Rückgabewerte

Keine.

Beispiel

/* Convert the attribute value into broker form */
data = CciNString((char *)startMarker, markedSize, pc->iCcsid);
/* Create a new name-value element for the attribute */
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);
}
/* Free the memory created in CciNString() */
free((void *)data);
/* Add the element */
cpiAddAsLastChild(&rc, element, newElement);
Zugehörige Konzepte
Benutzerdefinierte Parser
Benutzerdefinierte Erweiterungen
Zugehörige Tasks
Parser in C erstellen
Zugehörige Verweise
cpiElementNameSpace
C-Parser-Implementierungsfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
as08185_