WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

cniElementNamespace

Verwenden Sie diese Funktion, um den Wert des Attributs namespace für das angegebene Syntaxelement abzurufen.

Sie müssen den Namen des Syntaxelements zuvor mit cniSetElementNamespace oder cpiSetElementNamespace festgelegt haben.

Verwenden Sie diese Funktion, um eine Nachricht, die zu einer Domäne gehört, die Namespaces unterstützt, in einen Bitstrom zu konvertieren.

Syntax

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

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. Alle während der Ausführung dieses Aufrufs ausgelösten Ausnahmebedingungen werden beim nächsten vorgeordneten Knoten im Nachrichtenfluss 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
  • 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 ElementNamespace-Wert kopiert wird (Ausgabe). Eine Zeichenfolge (einschließlich eines Nullabschlusszeichens), die den Namespace-Wert darstellen, wird in diesen Puffer kopiert. Der Puffer muss ein Teil des Speichers sein, der zuvor vom Aufrufenden zugeordnet wurde.
length
Die Länge des Puffers (in Zeichen), die vom Parameter value angegeben wird (Eingabe).

Rückgabewerte

  • Bei Erfolg wird die Anzahl an in den Puffer kopierten 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 während der Ausführung eine Ausnahmebedingung auftritt, wird returnCode auf CCI_EXCEPTION gesetzt.

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 | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:22:01


ReferenzthemaReferenzthema | Version 8.0.0.5 | as07742_