cniSetElementNamespace

Legt das Attribut namespace für das angegebene Syntaxelement fest.

Dieses wird verwendet, wenn Sie eine Nachricht bearbeiten, die zu einer Namespace unterstützenden Domäne gehört.

Syntax

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

Parameter

returnCode
Der Rückkehrcode von der Funktion (Ausgabe). Die Angabe eines Nullzeigers bedeutet, dass der Knoten keine Fehler handhaben wird. Ist eine Eingabe nicht NULL, bedeutet die Ausgabe den Erfolgsstatus des Aufrufs. Jegliche während der Ausführung dieses Aufrufs ausgelösten Ausnahmebedingungen werden beim nächsten übergeordneten Knoten im Fluss erneut ausgelöst. 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 mit Null abgeschlossenen Zeichenfolge von CciChars an, die den Namespace-Wert darstellen (Ausgabe). Eine leere Zeichenfolge ist ein gültiger Wert für den Namespace. Elemente werden standardmäßig im Namespace der leeren Zeichenfolge erstellt, d. h. Sie könnten eine leere Zeichenfolge als Namespace angeben; dies ist aber nur von Wirkung, wenn das Element zuvor in einem anderen Namespace war und Sie den Namespace-Wert in eine leere Zeichenfolge ändern möchten.

Rückgabewerte

Keine. Beim Auftreten eines Fehlers gibt der Parameter returnCode den Grund dafür an.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as07746_