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

cniGetAttribute2

Utilice esta función para obtener el valor de un atributo en una instancia de nodo específica. El intermediario llama a esta función después de que se han establecido todos los atributos que el usuario despliega.

El resultado se graba en los datos de configuración persistentes del intermediario para asegurar que el nodo se configure correctamente después de detener e iniciar el proceso del grupo de ejecución.

Las responsabilidades del nodo son:
  1. Devolver una representación de caracteres del valor de atributo.
  2. Emitir una excepción si se produce un error.

Si se implementan las funciones cniGetAttribute y cniGetAttribute2, cniDefineNodeClass falla con un código de retorno CCI_INV_IMPL_FUNCTION.

Definida en Tipo Miembro
CNI_VFT Opcional iFpGetAttribute2

Sintaxis

CciSize cniGetAttribute2(
  int          returnCode,
  CciContext*  context,
  CciChar*     attrName,
  CciChar*     buffer,
  int          bufsize);

Parámetros

context
Dirección del contexto para la instancia del nodo, creado por el nodo y devuelto por la función cniCreateNodeContext (entrada).
returnCode (salida)
Puntero a un valor int. Por su parte, el nodo debe asegurar que este int almacena un valor que describe el estado de finalización. Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_ATTRIBUTE_UNKNOWN
  • CCI_BUFFER_TOO_SMALL
attrName
El nombre del atributo para el que se debe recuperar el valor (entrada).
buffer
La dirección de un almacenamiento intermedio en el que se copia el valor de atributo (salida).
bufsize
La longitud, en CciChars, del almacenamiento intermedio especificado en el parámetro buffer (entrada).

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 de atributo, returnCode se establece en CCI_BUFFER_TOO_SMALL y se devuelve el número de CciChar necesarios.
  • Si este nodo no reconoce el attrName, returnCode se establece en CCI_ATTRIBUTE_UNKNOWN.
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:29


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