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.

cniGetAttribute2

Verwenden Sie diese Funktion, um den Wert eines Attributs auf einer bestimmten Knoteninstanz abzurufen. Sie wird vom Broker aufgerufen, wenn alle vom Benutzer implementierten Attribute festgelegt sind.

Die Ergebnisse werden in die permanenten Konfigurationsdaten des Brokers geschrieben, um sicherzustellen, dass der Knoten nach dem Stoppen und Starten des Ausführungsgruppenprozesses korrekt konfiguriert ist.

Der Knoten hat folgende Aufgaben:
  1. Rückgabe einer Zeichendarstellung des Attributwerts.
  2. Ausgabe einer Ausnahmebedingung, wenn ein Fehler auftritt.

Wenn sowohl die Funktion cniGetAttribute als auch die Funktion cniGetAttribute2 implementiert werden, schlägt cniDefineNodeClass mit dem Rückkehrcode CCI_INV_IMPL_FUNCTION fehl.

Definiert in Typ Mitglied
CNI_VFT Optional iFpGetAttribute2

Syntax

CciSize cniGetAttribute2(
  int          returnCode,
  CciContext* context,
  CciChar*     attrName,
  CciChar*    buffer,
  int          bufsize);

Parameter

context
Die Adresse des Kontextes für die Instanz des Knotens, der vom Knoten erstellt und von der Funktion cniCreateNodeContext (Eingabe) zurückgegeben wurde.
returnCode (Ausgabe)
Zeiger auf einen int-Wert (Integer). Bei der Rückgabe muss der Knoten sicherstellen, dass dieser Integer einen Wert speichert, der den Abschlussstatus beschreibt. Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_ATTRIBUTE_UNKNOWN
  • CCI_BUFFER_TOO_SMALL
attrName
Der Name des Attributs, für das der Wert abgerufen werden soll (Eingabe).
buffer
Die Adresse eines Puffers, in den der Attributwert kopiert wird (Ausgabe).
bufsize
Die Länge (in CciChars) des Puffers, der im Parameter buffer angegeben wird (Eingabe).

Rückgabewerte

  • Bei erfolgreicher Ausführung wird der Attributwert in den angegebenen Puffer kopiert und die Anzahl der kopierten Zeichen des Typs CciChar wird 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 attrName dem Knoten nicht bekannt ist, wird returnCode auf CCI_ATTRIBUTE_UNKNOWN gesetzt.
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

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

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


ReferenzthemaReferenzthema | Version 8.0.0.5 | as24698_