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.

cniSearchElementInNamespace-Gruppe

Verwenden Sie dieses Element für die Suche nach einem Element, das die angegebenen Kriterien erfüllt.

Die Suche wird beim Syntaxelement begonnen, das im Elementargument angegeben ist. Jede der vier Funktionen stellt eine Suche in eine andere Richtung in der Baumstruktur bereit:
  1. cniSearchFirstChildInNamespace sucht die unmittelbaren untergeordneten Elemente des Anfangselements vom ersten untergeordneten Element an, bis entweder eine Übereinstimmung gefunden oder das Ende der Kette untergeordneter Elemente erreicht wird.
  2. cniSearchLastChildInNamespace sucht die unmittelbaren untergeordneten Elemente des Anfangselements vom letzten untergeordneten Element an, bis entweder eine Übereinstimmung gefunden oder das Ende der Kette untergeordneter Elemente erreicht wird.
  3. cniSearchNextSiblingInNamespace sucht vom Anfangselement an zu den nächsten gleichgeordneten Elementen, bis entweder eine Übereinstimmung gefunden oder das Ende der Kette gleichgeordneter Elemente erreicht wird.
  4. cniSearchPreviousSiblingInNamespace sucht vom Anfangselement an zu den vorherigen gleichgeordneten Elementen, bis entweder eine Übereinstimmung gefunden oder der Anfang der Kette gleichgeordneter Elemente erreicht wird.

Verwenden Sie diese Funktion, wenn Sie eine Nachricht suchen, die zu einer Domäne gehört, die Namespaces unterstützt.

Syntax

void cniSearchFirstChildInNamespace(
	int*           returnCode,
	CciElement*    targetElement,
	CciCompareMode mode,
	const CciChar* nameSpace,
	const CciChar* name,
	CciElementType type)		

void cniSearchLastChildInNamespace(
	int*           returnCode,
	CciElement*    targetElement,
	CciCompareMode mode,
	const CciChar* nameSpace,
	const CciChar* name,
	CciElementType type)		

void cniSearchNextSiblingInNamespace(
	int*           returnCode,
	CciElement*    targetElement,
	CciCompareMode mode,
	const CciChar* nameSpace,
	const CciChar* name,
	CciElementType type)		

void cniSearchPreviousSiblingInNamespace(
	int*           returnCode,
	CciElement*    targetElement,
	CciCompareMode mode,
	CciElementType type,
	const CciChar* nameSpace,
	const CciChar* name)		

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
targetElement
Die Adresse des Syntaxelementobjekts, bei dem die Suche beginnt (Eingabe).
mode
Der zu verwendende Suchmodus (Eingabe). Dieser Parameter gibt an, nach welcher Kombination aus Elementnamespace, Elementname und Elementtyp gesucht werden soll. Dies sind die möglichen Werte:
  • CCI_COMPARE_MODE_SPACE
  • CCI_COMPARE_MODE_SPACE_FULL_TYPE
  • CCI_COMPARE_MODE_SPACE_GENERIC_TYPE
  • CCI_COMPARE_MODE_SPACE_SPECIFIC_TYPE
  • CCI_COMPARE_MODE_SPACE_NAME
  • CCI_COMPARE_MODE_SPACE_NAME_FULL_TYPE
  • CCI_COMPARE_MODE_SPACE_NAME_GENERIC_TYPE
  • CCI_COMPARE_MODE_SPACE_NAME_SPECIFIC_TYPE
  • CCI_COMPARE_MODE_NULL
Wenn der Vergleichsmodus keine Übereinstimmung bezüglich des Namespace einschließt, werden alle Namespaces durchsucht. Dieses Verhalten unterscheidet sich von dem der cniSearchElement-Gruppe, bei der nur der Namespace mit der leeren Zeichenfolge berücksichtigt wird. Wenn Sie einen der gültigen Modi angeben, setzen Sie den Parameter nameSpace auf eine leere Zeichenfolge.
type
Der Elementtyp, nach dem gesucht werden soll (Eingabe). Verwenden Sie diesen Parameter nur, wenn der Suchmodus eine Übereinstimmung in Bezug auf den Typ einschließt.
nameSpace
Der Namespace, nach dem gesucht werden soll (Eingabe). Verwenden Sie diesen Parameter nur, wenn der Suchmodus eine Übereinstimmung in Bezug auf den Namespace einschließt.
name
Der Name, nach dem gesucht werden soll (Eingabe). Verwenden Sie diesen Parameter nur, wenn der Suchmodus eine Übereinstimmung in Bezug auf den Namen einschließt.

Rückgabewerte

Keine. Wenn ein Fehler auftritt, gibt der Parameter returnCode die Fehlerursache an.

Beispiel

 mode=CCI_COMPARE_MODE_SPACE ;
 ...

   if (forward) {
      firstChild = cniSearchFirstChildInNamespace(&rc, element, mode, space, 0,0);
    }else{
      firstChild = cniSearchLastChildInNamespace(&rc, element, mode, space, 0,0);

    }

    if (firstChild) {
      depth++;
      traceElement(firstChild,forward,space);
      depth--;
    }
    currentElement = firstChild;
    do{

      if (forward) {
        nextSibling = cniSearchNextSiblingInNamespace(&rc, currentElement,mode,space,0,0);
      }else{
        nextSibling = cniSearchPreviousSiblingInNamespace(&rc, currentElement,mode,space,0,0);
      }
      if (nextSibling) {
        traceElement(nextSibling,forward,space);
        currentElement=nextSibling;
      }

    }while (nextSibling) ;
    
  }
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 | as07744_