cniGetAttribute2

Diese Funktion ruft den Wert eines Attributs auf einer bestimmten Knoteninstanz ab. Sie wird vom Nachrichtenbroker aufgerufen, wenn alle vom Benutzer implementierten Attribute, gesetzt sind. Die Ergebnisse werden in den permanenten Konfigurationsspeicher des Brokers geschrieben, um sicherzustellen, dass der Knoten nach dem Stoppen und Starten des Ausführungsgruppenprozesses korrekt konfiguriert ist.

Der Knoten ist an diesem Punkt für Folgendes zuständig:
  1. Rückgabe einer Zeichendarstellung des Attributwerts.
  2. Ausgabe einer Ausnahmebedingung, wenn ein Fehler auftritt.

Wenn sowohl cniGetAttribute als auchcniGetAttribute2 implementiert werden, schlägt cniDefineNodeClass mit 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.
Rückkehrcode (Ausgabe)
Zeiger auf ein int (Integer). Bei Rückgabe sollte der Knoten sicherstellen, dass dieses 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 CciChar) 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 | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as24698_