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.

Diese Funktion gibt den Namen eines Knotenattributs durch einen Index angegeben zurück. Sie wird vom Nachrichtenbroker aufgerufen, wenn der Broker die Namen von Attributen benötigt, die von einer bestimmten Instanz eines Knotens unterstützt werden. Es muss gewährleistet sein, dass die Funktion die Attribute in einer bekannten, definierten Reihenfolge zurückgibt und den Attributnamen durch den Indexparameter dargestellt zurückgibt.

Wenn sowohl cniGetAttributeName als auch cniGetAttributeName2 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, der vom Knoten erstellt und von der Funktion cniCreateNodeContext (Eingabe) zurückgegeben wurde.
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 | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
as07470_