cniGetAttributeName

Einschränkung: Diese Funktion beschränkt die Länge des Attributwerts. Diese Funktion wird nur für die Abwärtskompatibilität bereitgestellt. Sie sollten cniGetAttributeName2 implementieren.

Zurückgeben des Namens eines Knotenattributs, das durch einen Index angegeben ist. Die Funktion wird vom Nachrichtenbroker aufgerufen, wenn der Broker die Namen von Attributen erfordert, die von einer bestimmten Instanz eines Knotens unterstützt werden. Die Funktion muss garantieren, die Attribute in einer bekannten, definierten Reihenfolge und den Attributnamen, der durch den Indexparameter dargestellt wird, zurückzugeben.

Wenn sowohl cniGetAttributeName als auchcniGetAttributeName2 implementiert werden, schlägt cniDefineNodeClass mit CCI_INV_IMPL_FUNCTION fehl.

Definiert in Typ Mitglied
CNI_VFT Optional iFpGetAttributeName

Syntax

int cniGetAttributeName(
  CciContext*  context,
  int          index,
  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).
index
Gibt den Index des Attributnamens an (Eingabe). Der Index der Attribute beginnt bei Null.
buffer
Die Adresse eines Puffers, in den der Attributname kopiert wird (Ausgabe).
bufsize
Die Länge (in Byte) des Puffers, der im Parameter buffer angegeben ist (Eingabe).

Rückgabewerte

Bei Erfolg wird Null und der Name des Attributs im angegeben Puffer zurückgegeben. Wird das Ende der Attributliste erreicht, 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
as07470_