cciGetNodeAttribute

Questa funzione restituisce il valore dell'attributo specificato.

Sintassi

CciSize  cciGetNodeAttribute (int*           returnCode,
                         CciNode*          node,
                         CciChar*     name,
                         CciChar*          value,
                         CciSize        length);

Parametri

returnCode (output)
Riceve il codice di ritorno dalla funzione (output).
  • CCI_INV_BUFFER_TOO_SMALL

    Il buffer fornito non era sufficientemente capiente per contenere il valore del tipo di nodo.

node (input)
Questo è l'handle in un nodo.
name (input)
Questo è un puntatore a una stringa con terminazione NULL di CciChar che specifica il nome dell'attributo del nome su cui si sta eseguendo la query.
value (output)
Indirizzo di un buffer, assegnato dal chiamante per conservare il valore dell'attributo.
length
La lunghezza, in CciChars, del buffer assegnato dal chiamante.

Valori di restituzione

  • Se ha esito positivo, il valore 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 valore di attributo, returnCode è impostato su CCI_BUFFER_TOO_SMALL e viene restituito il numero di CciChars richiesti.
  • Se name specifica un nome attributo non adeguato per il nodo indicato, returnCode viene impostato su CCI_ATTRIBUTE_UNKOWN.

Esempio

void myPropagatedMessageCallback(
                        CciMessage*  message,
                        CciMessage*    localEnvironment,
                        CciMessage*  exceptionList,
                        CciMessage*    environment,
                        CciConnection* connection){
 	int rc = CCI_SUCCESS;  
   CciNode* sourceNode = cciGetSourceNode(&rc,
                                          connection);
   /*Controllare ora i valori imprevisti nell'rc*/
   CciChar   queueNameAttribute[16];
   cciMbsToUcs(&rc,
               "queueName",
               queueNameAttribute,
               16,
               BIP_DEF_COMP_CCSID);
 /*Controllare ora i valori imprevisti nell'rc*/

   CciChar queueName [512];
   sourceNodeQueueNameLength = cciGetNodeType(&rc,
                                         sourceNode,
                                         queueName,
                                         512);
   /*Controllare ora i valori imprevisti nell'rc*/
   /*se rc è CCI_BUFFER_TOO_SMALL ridimensionarlo e riprovare*/
 /*sourceNodeQueueNameLength conserverà la dimensione richiesta o effettiva */
Concetti correlati
Sviluppo di uscite utente
Attività correlate
Sviluppo di un'uscita utente
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as36010_