cniGetAttributeName

Diese Funktion gibt den Namen eines durch einen Index angegebenen Knotenattributs zurück.

Einschränkung: Diese Funktion beschränkt die Länge des Attributwerts. Sie wird nur zur Kompatibilität mit früheren Versionen bereitgestellt. Sie sollten cniGetAttributeName2 implementieren.

Diese 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 (Eingabe) zurückgegeben.
index
Gibt den Index des Attributnamens an (Eingabe). Der Index der Attribute fängt bei null an.
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 wird (Eingabe).

Rückgabewerte

Wenn die Ausführung erfolgreich war, wird null zurückgegeben, und der Name des Attributs wird im angegebenen Puffer zurückgegeben. Wenn das Ende der Attributliste erreicht ist, wird ein Wert ungleich null zurückgegeben.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:29:55

as07470_