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.

Esta función obtiene 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 informe que recupera el valor de un atributo de nodo. El intermediario verifica que el nombre de atributo sea válido para el nodo.

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, 2005 Última actualización: 11/11/2005
as07460_