cniGetAttributeName

Limitazione: Questa funzione impone una limitazione sulla lunghezza del valore di attributo. Viene fornita solo per la compatibilità retroattiva. E' necessario implementare cniGetAttributeName2.

Restituisce il nome di un attributo del nodo specificato da un indice. Viene richiamata dal broker di messaggi quando il broker richiede i nomi degli attributi supportati da una determinata istanza di un nodo. La funzione deve garantire la restituzione degli attributi secondo un determinato ordine e la restituzione del nome di attributo rappresentato dal parametro di indice.

Se sono implementate sia cniGetAttributeName che cniGetAttributeName2, cniDefineNodeClass ha esito negativo con CCI_INV_IMPL_FUNCTION.

Definito in Tipo Membro
CNI_VFT Facoltativo iFpGetAttributeName

Sintassi

int cniGetAttributeName(
  CciContext*  context,
  int          index,
  CciChar*     buffer,
  int          bufsize);

Parametri

context
L'indirizzo del contesto per l'istanza del nodo, come creato dal nodo e restituito dalla funzione cniCreateNodeContext (input).
index
Specifica l'indice del nome di attributo (input). L'indice degli attributi inizia da zero.
buffer
L'indirizzo di un buffer in cui viene copiato il nome di attributo (output).
bufsize
La lunghezza, in byte, del buffer specificato nel parametro buffer (input).

Valori di restituzione

Se ha esito positivo, viene restituito il valore zero e il nome dell'attributo viene restituito nel buffer specificato. Se è stata raggiunta la fine dell'elenco di attributi, viene restituito un valore diverso da zero.

Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as07470_