cniRootElement

Fornisce l'elemento di sintassi root associato ad un determinato messaggio. Viene restituito l'elemento root associato (e di proprietà) all'oggetto messaggio identificato dal parametro message. Quando un oggetto messaggio viene creato dal broker, viene creato automaticamente un elemento root.

Sintassi

CciElement* cniRootElement(
  int*      returnCode,
  CciMessage  *message);

Parametri

returnCode
Il codice di ritorno dalla funzione (output).
I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
message
L'indirizzo dell'oggetto messaggio (input).

Valori di restituzione

Se ha esito positivo, viene restituito l'indirizzo dell'oggetto elemento root. Altrimenti, viene restituito un valore zero (CCI_NULL_ADDR) e il parametro returnCode indica il motivo dell'errore.

Esempio

   inRootElement = cniRootElement(&rc, message);
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as07680_