cniGetAttributeName

Esta función devuelve el nombre de un atributo de nodo especificado por un índice. La invoca el intermediario de mensajes cuando el intermediario necesita los nombres de los atributos a los que da soporte una instancia concreta de un nodo. La función debe garantizar la devolución de los atributos en un orden definido y conocido, así como la devolución del nombre de atributo representado por el parámetro de índice.

Definida en Tipo Miembro
CNI_VFT Opcional iFpGetAttributeName

Sintaxis

int cniGetAttributeName(
  CciContext*  context,
  int          index,
  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).
index
Especifica el índice del nombre de atributo (entrada). El índice de los atributos empieza a partir de cero.
buffer
Dirección de un almacenamiento intermedio en el que se copia el nombre 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 el nombre del atributo se devuelve en el almacenamiento intermedio especificado. Si se llega al final de la lista de atributos, 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
cniGetAttribute