cniGetAttribute

Einschränkung: Diese Funktion beschränkt die Länge des Attributwerts. Diese Funktion wird nur für die Abwärtskompatibilität bereitgestellt. Sie sollten cniGetAttribute2 implementieren.
Beginn der ÄnderungDiese Funktion ruft den Wert eines Attributs auf einer bestimmten Knoteninstanz ab. Sie wird wie folgt vom Nachrichtenbroker aufgerufen:
  • Bevor die Kontenkonfiguration implementiert wird, um Standardwerte für alle Attribute, die möglicherweise Attribute des Frameworks überschreiben, festzulegen.
  • Nach dem Einrichten der implementierten Konfiguration, um die Konfiguration in die Datenbank des Brokers zu schreiben. Dadurch wird sichergestellt, dass die Konfiguration nach dem Beenden und Neustarten der Ausführungsgruppe weiter verfügbar ist.
Ende der Änderung
Die Zuständigkeiten des Knotens sind an diesem Punkt die Folgenden:
  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 zurückgegeben (Eingabe).
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 | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as07460_