cniSetElementNamespace

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

Diese Funktion wird verwendet, wenn eine Nachricht bearbeitet wird, die zu einer Domäne gehört, bei der der Namespace berücksichtigt werden muss.

Syntax

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

Parameter

returnCode
Der Rückkehrcode aus der Funktion (Ausgabe). Wenn ein Nullzeiger angegeben wird, bedeutet dies, dass der Knoten nicht für Fehler zuständig sein möchte. Wenn die Eingabe nicht NULL ist, gibt die Ausgabe den Erfolgsstatus des Aufrufs an. Alle Ausnahmebedingungen, die bei der Ausführung dieses Aufrufs ausgegeben werden, werden beim nächsten vorgeschalteten Knoten im Nachrichtenfluss erneut ausgegeben. Rufen Sie cciGetLastExceptionData auf, um weitere Informationen zu der Ausnahmebedingung zu erhalten. Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
targetElement
Gibt die Adresse des Zielsyntaxelementobjekts an (Eingabe).
value
Gibt die Adresse einer Zeichenfolge mit null am Ende (CciChars) an, die den Namespaceswert darstellt (Ausgabe). 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. Sie könnten also eine leere Zeichenfolge als Namespace angeben, dies bewirkt jedoch nur etwas, 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. Wenn ein Fehler auftritt, gibt der Parameter returnCode die Fehlerursache an.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
as07746_