cniGetAttribute2

Esta función obtiene el valor de un atributo en una instancia de nodo específica. El intermediario de mensajes invoca esta función después de establecer todos los atributos que el usuario despliega. El resultado se escribe en el almacenamiento de configuración persistente del intermediario, para asegurar que el nodo esté configurado correctamente después de detener e iniciar el proceso del grupo de ejecución.

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

Si se implementan ambos, cniGetAttribute y cniGetAttribute2, cniDefineNodeClass falla con 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
Nombre del atributo para el que se debe recuperar el valor (entrada).
buffer
Dirección de un almacenamiento intermedio en el que se copia el valor de atributo (salida).
bufsize
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 tamaño del almacenamiento intermedio no es 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 este nodo no conoce attrName, returnCode se establece en CCI_ATTRIBUTE_UNKNOWN.
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as24698_