cniGetAttributeName2

Questa funzione 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 iFpGetAttributeName2

Sintassi

CciSize cniGetAttributeName2(
  int          returnCode,
  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).
returnCode (output)
Puntatore su int. Il nodo deve quindi assicurare che tale int memorizzi un valore che descrive lo stato di completamento. I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_ATTRIBUTE_UNKNOWN
  • CCI_BUFFER_TOO_SMALL
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 CciChars, del buffer specificato nel parametro buffer (input).

Valori di restituzione

  • Se ha esito positivo, il nome di attributo viene copiato nel buffer fornito e viene restituito il numero di caratteri CciChar copiati.
  • Se il buffer non è grande a sufficienza per contenere il nome di attributo, returnCode è impostato su CCI_BUFFER_TOO_SMALL e viene restituito il numero di CciChars richiesti.
  • Se è stata raggiunta la fine dell'elenco di attributi e il nome di attributo non è stato rilevato, returnCode è impostato su CCI_ATTRIBUTE_UNKNOWN. Ad esempio, quando index è maggiore di n-1, dove n è il numero di attributi per questo nodo.
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as24699_