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.

Diese Funktion ruft den Wert eines Attributs auf einer bestimmten Knoteninstanz ab. Sie wird vom Nachrichtenbroker aufgerufen, wenn eine Berichtsanforderung empfangen wird, die den Wert eines Knotenattributs abruft. Der Broker überprüft, ob der Attributname für den Knoten gültig 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 iFpGetAttribute

Syntax

int cniGetAttribute(
  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.
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 wird (Eingabe).

Rückgabewerte

Wenn die Ausführung erfolgreich war, wird null zurückgegeben, und die Zeichendarstellung des Wertes des Attributs wird im angegebenen Puffer 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
as07460_