cniElementNamespace

Diese Funktion ruft den Wert des Attributs namespace für das angegebene Syntaxelement ab. Der Name des Syntaxelements wurde zuvor mit cniSetElementNamespace oder cpiSetElementNamespace festgelegt.

Diese Funktion wird verwendet, wenn eine Nachricht, die zu einer Domäne gehört, bei der der Namensbereich berücksichtigt werden muss, in einen Bitstrom konvertiert wird.

Syntax

CciSize cniElementNamespace(
int*                   returnCode,
CciElement*       targetElement,
const CciChar*             value,
CciSize length)

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
  • CCI_INV_DATA_BUFLEN
  • CCI_INV_BUFFER_TOO_SMALL
targetElement
Gibt die Adresse des Zielsyntaxelementobjekts an (Eingabe).
value
Gibt die Adresse eines Puffers an, in den der Namespaceswert des Elements kopiert wird (Ausgabe). Eine Zeichenfolge (einschließlich Nullabschlusszeichen), die den Namespaceswert darstellt, wird in diesen Puffer kopiert. Der Puffer sollte Teil des Speichers sein, der zuvor vom Aufrufenden zugeordnet wurde.
length
Die Länge (in Zeichen) des Puffers, der im Parameter value angegeben wird (Eingabe).

Rückgabewerte

  • Bei erfolgreicher Ausführung wird die Anzahl der in den Puffer kopierten Zeichen (CciChars) zurückgegeben.
  • Wenn der Puffer für den Attributwert nicht groß genug ist, wird als Wert für returnCode CCI_BUFFER_TOO_SMALL festgelegt, und die erforderliche Anzahl der Zeichen (CciChars) wird zurückgegeben.
  • Wenn bei der Ausführung eine Ausnahmebedingung auftritt, wird als Wert für returnCode CCI_EXCEPTION festgelegt.

Beispiel

if (element != 0) {
/*get name*/
cniElementName(&rc, element, (CciChar*)&elementName, sizeof(elementName));
/*get namespace*/
elementNamespace=(CciChar*)malloc(sizeof(CciChar) * elementNamespaceLength);
elementNamespaceLength = cniElementNamespace(&rc,
element,
elementNamespace,
elementNamespaceLength);
if (rc==CCI_BUFFER_TOO_SMALL){
free(elementNamespace);
elementNamespace=(CciChar*)malloc(sizeof(CciChar) * elementNamespaceLength);
elementNamespaceLength = cniElementNamespace(&rc,
element,
elementNamespace,
elementNamespaceLength);
}
checkRC(rc);
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
as07742_