cniGetAttribute

Esta función obtiene el valor de un atributo en una instancia de nodo específica.

Restricción: Esta función impone una limitación en la longitud del valor del atributo. Esta función sólo se proporciona por compatibilidad con versiones anteriores. Debe implementar cniGetAttribute2.
Esta función la invoca el intermediario:
  • Antes de desplegar la configuración de nodos, con el fin de averiguar los valores predeterminados de los atributos que pueden alterar temporalmente los atributos que son propiedad de la infraestructura.
  • Después de establecer la configuración desplegada, con el fin de grabar la configuración en la base de datos del intermediario. Esta llamada asegura que la configuración persista tras la conclusión y el reinicio del grupo de ejecución.
Las responsabilidades del nodo son:
  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 iFpGetAttribute

Sintaxis

int cniGetAttribute(
  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).
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 bytes, del almacenamiento intermedio especificado en el parámetro buffer (entrada).

Valores de retorno

Si la ejecución se realiza satisfactoriamente, se devuelve cero y en el almacenamiento intermedio especificado se devuelve la representación de caracteres del valor del atributo. 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, 2009Copyright IBM Corporation 1999, 2009.
Última actualización : 2009-02-16 13:56:10

as07460_