WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

cciGetNodeAttribute

La función cciGetNodeAttribute devuelve el valor del atributo especificado.

Sintaxis

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

Parámetros

returnCode (salida)
Recibe el código de retorno de la función (salida).
  • CCI_INV_BUFFER_TOO_SMALL

    El almacenamiento intermedio proporcionado no era lo suficientemente grande para contener el valor del tipo del nodo.

node (entrada)
Este es un manejador para un nodo.
name (entrada)
Este es un puntero a una serie finalizada en nulo de CciChar que especifica el nombre del atributo del nodo que se va a consultar.
value (salida)
Dirección de un almacenamiento intermedio, asignado por el emisor de la llamada para que contenga el valor del atributo.
length
La longitud, en CciChars, del almacenamiento intermedio asignado por el emisor de la llamada.

Valores de retorno

  • Si la ejecución se realiza satisfactoriamente, el valor de atributo se copia en el almacenamiento intermedio proporcionado y se devuelve el número de caracteres CciChar copiados.
  • Si el almacenamiento intermedio no es lo suficientemente grande para contener el valor del atributo, returnCode se establece en CCI_BUFFER_TOO_SMALL y se devuelve el número de CciChars necesarios.
  • Si name especifica un nombre de atributo que no es apropiado para el nodo específico, returnCode se establece en CCI_ATTRIBUTE_UNKOWN.

Ejemplo

void myPropagatedMessageCallback(
                        CciMessage*  message,
                        CciMessage*    localEnvironment,
                        CciMessage* exceptionList,
                        CciMessage*    environment,
                        CciConnection* connection){
 	 int rc = CCI_SUCCESS;  
   CciNode* sourceNode = cciGetSourceNode(&rc,
                                          connection);
   /*debe comprobar ahora el código de retorno de los valores no previstos*/
   CciChar   queueNameAttribute[16];
   cciMbsToUcs(&rc,
               "queueName",
               queueNameAttribute,
               16,
               BIP_DEF_COMP_CCSID);
 /*debe comprobar ahora el código de retorno de los valores no previstos*/

   CciChar queueName [512];
   sourceNodeQueueNameLength = cciGetNodeType(&rc,
                                         sourceNode,
                                         queueName,
                                         512);
   /*debe comprobar ahora el código de retorno de los valores no previstos*/
   /*si el código de retorno es CCI_BUFFER_TOO_SMALL, cambie el tamaño y vuelva a intentarlo*/
 /*sourceNodeQueueNameLength debe contener el tamaño real o necesario */
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:31


Tema de referenciaTema de referencia | Versión 8.0.0.5 | as36010_