cniSetAttribute

Angeben des Werts eines Attributs zu einer bestimmten Knoteninstanz. Die Funktion wird vom Nachrichtenbroker aufgerufen, wenn eine Konfigurationsanforderung empfangen wird, die versucht, den Wert eines Knotenattributs anzugeben, oder während der Initialisierung des Knotens. Ein Knoten empfängt Anforderungen zum Angeben von Attributen für die Basis. Wird ein unbekannter Attributwert empfangen, muss diese Funktion einen Wert ungleich Null zurückgeben, damit der Broker die Anforderung korrekt verarbeitet.

Die Zuständigkeiten des Knotens sind an diesem Punkt die Folgenden:
  1. Prüfen, ob der Wert des Attributs korrekt angegeben wurde. Ist dies nicht der Fall, sollte eine Konfigurationsausnahme mittels der Funktion cciThrowException ausgelöst werden.
  2. Speichern des Werts des Attributs im Kontext, der in der Funktion cniCreateNodeContext hätte zugeordnet werden sollen.
  3. Beim Auftreten eines Fehlers eine Konfigurationsausnahme mittels der Funktion cciThrowException auslösen.
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, wie vom Knoten erstellt und von der Funktion cniCreateNodeContext zurückgegeben (Eingabe).
attrName
Der Name des Attributs, dessen Wert angegeben werden soll (Eingabe).
attrValue
Der Wert des Attributs (input).

Rückgabewerte

Bei Erfolg wird Null 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
as07490_