cniSetAttribute

Establece el valor de un atributo en una instancia de nodo específica. El intermediario de mensajes invoca esta función cuando se recibe 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 de cero para que el intermediario procese la petición correctamente.

Las responsabilidades del nodo en este punto consisten en:
  1. Verificar que el valor del atributo esté especificado correctamente. Si no es así, se deberá emitir una excepción de configuración utilizando la función cciThrowException.
  2. Almacenar el valor del atributo en el contexto, que se deberá haber 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, creado por el nodo y devuelto por la función cniCreateNodeContext (entrada).
attrName
Nombre del atributo cuyo valor se debe establecer (entrada).
attrValue
Valor del atributo (entrada).

Valores de retorno

Si la ejecución se realiza satisfactoriamente, se devuelve cero. Si el nombre del atributo no identifica ninguno soportado por el nodo, se devuelve un valor distinto de cero.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as07490_