cniGetAttribute

Esta función obtiene el valor de un atributo en una instancia de nodo específica. La invoca el intermediario de mensajes al recibirse una petición de informe en la que se recupera el valor de un atributo de nodo. El intermediario verifica que el nombre de atributo sea válido para el nodo.

Las responsabilidades del nodo llegado este punto son las siguientes:
  1. Devolver una representación de caracteres del valor de atributo.
  2. Devolver una serie de caracteres nula si los datos son confidenciales y no deben mostrarse en informes.
  3. Emitir una excepción si se produce un error.
Definida en Tipo Miembro
CNI_VFT Opcional iFpGetAttribute

Sintaxis

int cniGetAttribute(
  CciContext*  context,
  CciChar*     attrName,
  CciChar*     buffer,
  int          bufsize);

Parámetros

context
Dirección del contexto para la instancia del nodo, creada por el nodo y devuelta por la función cniCreateNodeContext (entrada).
attrName
Nombre del atributo para el que va a recuperarse el valor (entrada).
buffer
Dirección de un almacenamiento intermedio en el que se copia el valor de atributo (salida).
bufsize
Longitud, en bytes, del almacenamiento intermedio especificado en el parámetro buffer (entrada).

Valores de retorno

Si la función se ejecuta correctamente, se devuelve el valor cero, y la representación de caracteres del valor del atributo se devuelve en el almacenamiento intermedio especificado. Si el nombre del atributo no identifica un atributo al que el nodo dé soporte, se devuelve un valor distinto a cero.

Conceptos relacionados
Nodos de entrada definidos por el usuario
Nodos de proceso de mensajes definidos por el usuario
Nodos de salida definidos por el usuario

Tareas relacionadas
Creación de un nodo de entrada en C
Creación de un nodo de proceso de mensajes en C

Referencia relacionada
Funciones de implementación de nodo de lenguaje C
cniCreateNodeContext
cniGetAttributeName