cniGetAttribute

Limitazione: Questa funzione impone una limitazione sulla lunghezza del valore di attributo. Viene fornita solo per la compatibilità retroattiva. E' necessario implementare cniGetAttribute2.
Inizio modificaQuesta funzione fornisce il valore di un attributo su una determinata istanza del nodo. Viene invocata dal broker del messaggio come segue:
  • Prima che la configurazione dei nodi venga distribuita, al fine di accertarsi dei valori predefiniti di tutti gli attributi che possono sovrascrivere quelli appartenenti al framework.
  • Dopo l'impostazione della configurazione distribuita, per poterla scrivere nel database del broker. in questo modo viene garantito il mantenimento della configurazione al di là degli arresti e dei riavvii del gruppo di esecuzione
Fine modifica
Il nodo a questo punto deve eseguire quando riportato di seguito:
  1. Restituire una rappresentazione di caratteri del valore di attributo.
  2. Generare un'eccezione se si verifica un errore.
Se sono implementate sia cniGetAttribute che cniGetAttribute2, cniDefineNodeClass ha esito negativo con CCI_INV_IMPL_FUNCTION.
Definito in Tipo Membro
CNI_VFT Facoltativo iFpGetAttribute

Sintassi

int cniGetAttribute(
  CciContext*  context,
  CciChar*     attrName,
  CciChar*     buffer,
  int          bufsize);

Parametri

context
L'indirizzo del contesto per l'istanza del nodo, come creato dal nodo e restituito dalla funzione cniCreateNodeContext (input).
attrName
Il nome dell'attributo per il quale deve essere richiamato il valore (input).
buffer
L'indirizzo di un buffer in cui viene copiato il valore di attributo (output).
bufsize
La lunghezza, in byte, del buffer specificato nel parametro buffer (input).

Valori di restituzione

Se ha esito positivo, viene restituito il valore zero e la rappresentazione di caratteri del valore dell'attributo viene restituita nel buffer specificato. Se il nome dell'attributo non ne identifica uno supportato dal nodo, viene restituito un valore diverso da zero.

Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as07460_