cniGetAttribute

Restricción: Esta función impone una limitación a la longitud del valor del atributo y solamente se proporciona por compatibilidad con versiones anteriores. Debe implementar cniGetAttribute2.
Inicio del cambioEsta función obtiene el valor de un atributo en una instancia de nodo específica. La invoca el intermediario de mensajes como se indica a continuación:
  • Antes de desplegar la configuración de nodos, con el fin de averiguar los valores por omisión 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. Así se garantiza que la configuración persiste tras la conclusión y el reinicio del grupo de ejecución.
Fin del cambio
Las responsabilidades del nodo en este punto consisten en:
  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, 2006 Última actualización: 22/08/2006
as07460_