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.

cniGetAttribute

Diese Funktion ruft den Wert eines Attributs auf einer bestimmten Knoteninstanz ab.

Einschränkung: Diese Funktion beschränkt die Länge des Attributwerts. Diese Funktion wird nur zur Kompatibilität mit früheren Versionen bereitgestellt. Sie sollten cniGetAttribute2 implementieren.
Diese Funktion wird in folgenden Situationen vom Broker aufgerufen:
  • Bevor die Kontenkonfiguration implementiert wird, um Standardwerte für alle Attribute festzulegen, die möglicherweise Attribute des Frameworks überschreiben.
  • Nach dem Einrichten der implementierten Konfiguration, um die Konfiguration in die Datenbank des Brokers zu schreiben. Dieser Aufruf stellt sicher, dass die Konfiguration nach dem Beenden und Neustarten der Ausführungsgruppe weiter verfügbar ist.
Der Knoten hat folgende Aufgaben:
  1. Zurückgeben einer Zeichendarstellung des Attributwerts.
  2. Bei Auftreten eines Fehlers eine Ausnahmebedingung auslösen.
Wenn sowohl cniGetAttribute als auchcniGetAttribute2 implementiert werden, schlägt cniDefineNodeClass mit CCI_INV_IMPL_FUNCTION fehl.
Definiert in Typ Mitglied
CNI_VFT Optional iFpGetAttribute

Syntax

int cniGetAttribute(
  CciContext* context,
  CciChar*     attrName,
  CciChar*    buffer,
  int          bufsize);

Parameter

context
Die Adresse des Kontextes für die Instanz des Knotens, wie vom Knoten erstellt und von der Funktion cniCreateNodeContext (Eingabe) zurückgegeben.
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 Byte) des Puffers, der im Parameter buffer angegeben ist (Eingabe).

Rückgabewerte

Bei Erfolg wird Null zurückgegeben, und die Zeichendarstellung des Attributwerts wird im angegeben Puffer zurückgegeben. Wenn der Name des Attributs keines identifiziert, das vom Knoten unterstützt wird, wird ein Wert ungleich null zurückgegeben.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

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

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


ReferenzthemaReferenzthema | Version 8.0.0.5 | as07460_