cniSetAttribute

Diese Funktion legt den Wert eines Attributs auf einer bestimmten Knoteninstanz fest. Sie wird vom Nachrichtenbroker aufgerufen, wenn eine Konfigurationsanforderung empfangen wird, die versucht, den Wert eines Knotenattributs festzulegen, oder bei der Initialisierung des Knotens. Ein Knoten empfängt Anforderungen zum Festlegen von Attributen für die Basis. Wenn ein unbekannter Attributwert empfangen wird, muss diese Funktion einen Wert ungleich null zurückgeben, so dass der Broker die Anforderung korrekt verarbeitet.

Der Knoten ist an diesem Punkt für Folgendes zuständig:
  1. Überprüfung, ob der Wert des Attributs korrekt angegeben ist. Ist dies nicht der Fall, sollte mit Hilfe der Funktion cciThrowException eine Konfigurationsausnahmebedingung ausgegeben werden.
  2. Speichern des Attributwerts im Kontext, der in der Funktion cniCreateNodeContext zugeordnet worden sein sollte.
  3. Ausgabe einer Konfigurationsausnahmebedingung, wenn ein Fehler auftritt, mit Hilfe der Funktion cciThrowException.
Definiert in Typ Mitglied
CNI_VFT Optional iFpSetAttribute

Syntax

int cniSetAttribute(
  CciContext*  context,
  CciChar*     attrName,
  CciChar*     attrValue);

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.
attrName
Der Name des Attributs, dessen Wert festgelegt werden soll (Eingabe).
attrValue
Der Wert des Attributs (Eingabe).

Rückgabewerte

Bei erfolgreicher Ausführung wird der Wert null zurückgegeben. Wenn der Attributname nicht vom Knoten unterstützt wird, wird ein Wert ungleich null zurückgegeben.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
as07490_