cniGetAttribute2

Questa funzione fornisce il valore di un attributo su una determinata istanza del nodo. Viene richiamata dal broker dei messaggi dopo che sono stati impostati tutti gli attributi che vengono distribuiti dall'utente. I risultati vengono scritti nella memoria di configurazione permanente del broker al fine di garantire che il nodo venga configurato correttamente dopo che l'elaborazione del gruppo di esecuzione viene arrestata e avviata.

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 iFpGetAttribute2

Sintassi

CciSize cniGetAttribute2(
  int          returnCode,
  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).
returnCode (output)
Puntatore su int. Il nodo deve quindi assicurare che tale int memorizzi un valore che descrive lo stato di completamento. I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_ATTRIBUTE_UNKNOWN
  • CCI_BUFFER_TOO_SMALL
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 CciChars, del buffer specificato nel parametro buffer (input).

Valori di restituzione

  • Se ha esito positivo, il valore di attributo viene copiato nel buffer fornito e viene restituito il numero di caratteri CciChar copiati.
  • Se il buffer non è grande a sufficienza per contenere il valore di attributo, returnCode è impostato su CCI_BUFFER_TOO_SMALL e viene restituito il numero di CciChars richiesti.
  • Se attrName non è sconosciuto a questo nodo,returnCode è impostato su CCI_ATTRIBUTE_UNKNOWN.
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as24698_