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

cciGetNodeName

Esta función devuelve el nombre del nodo especificado.

WebSphere Message Broker Toolkit asigna internamente el nombre, que es exclusivo en el flujo de mensajes. La etiqueta que asigna a un nodo el diseñador de flujos de mensajes en el Editor de flujos de mensajes puede obtenerse llamando a cciGetNodeAttribute para que lea el atributo de la etiqueta.

Sintaxis

CciSize  getNodeName (int*                    returnCode,
                                        CciNode*          node,
                                        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 nombre del nodo.

node (entrada)
Este es un manejador para un nodo.
value (salida)
Dirección de un almacenamiento intermedio, asignado por el emisor de la llamada para que contenga el valor del nombre del nodo.
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 nombre del nodo 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 nombre del nodo, returnCode se establece en CCI_BUFFER_TOO_SMALL y se devuelve el número de CciChars necesarios.

Ejemplo

void myPropagatedMessageCallback(
                        CciMessage*  message,
                        CciMessage*    localEnvironment,
                        CciMessage* exceptionList,
                        CciMessage*    environment,
                        CciConnection* connection){
 
	 int rc = CCI_SUCCESS;
   CciNode* targetNode = cciGetTargetNode(&rc,
                                          connection);

 

   CciChar targetNodeName [initialStringBufferLength];
   targetNodeNameLength = cciGetNodeName(&rc,
                                         targetNode,
                                         targetNodeName,
                                         initialStringBufferLength);
   /*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*/

}  
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 | as35990_