cniSetAttribute

Esta función establece el valor de un atributo en una instancia de nodo específica. El intermediario de mensajes invoca esta función al recibirse una petición de configuración que intenta establecer el valor de un atributo de nodo, o durante la inicialización del nodo. Un nodo recibe peticiones para establecer atributos para la base. Si se recibe un valor de atributo desconocido, esta función debe devolver un valor distinto a cero para que el intermediario procese la petición correctamente.

Las responsabilidades del nodo llegado este punto son las siguientes:
  1. Verificar que el valor del atributo esté especificado correctamente. Si no es así, deberá emitirse una excepción de configuración utilizando la función cciThrowException.
  2. Almacenar el valor del atributo en el contexto, que deberá haberse asignado en la función cniCreateNodeContext.
  3. Emitir una excepción de configuración si se produce un error, utilizando la función cciThrowException.
Definida en Tipo Miembro
CNI_VFT Opcional iFpSetAttribute

Sintaxis

int cniSetAttribute(
  CciContext*  context,
  CciChar*     attrName,
  CciChar*     attrValue);

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 cuyo valor debe establecerse (entrada).
attrValue
Valor del atributo (entrada).

Valores de retorno

Si la función se ejecuta correctamente, se devuelve cero. 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
cciThrowException