cniWriteBuffer

Scrive la struttura ad albero dell'elemento di sintassi associata al messaggio specificato nel buffer di dati di proprietà dell'oggetto messaggio. Questa funzione viene utilizzata di solito dai nodi di output. Questa operazione serializza la struttura ad albero dell'elemento in un flusso di bit, che può quindi essere elaborato come una sequenza di byte contigui. Questa funzione deve essere utilizzata quando il flusso di bit viene scritto su una destinazione esterna al broker.

Affinché sia possibile eseguire questa chiamata, è necessario richiamare prima cniFinalize.

Sintassi

void cniWriteBuffer(
  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 per il quale deve essere eseguita la serializzazione della struttura ad albero dell'elemento (input).

Valori di restituzione

Nessuno. Se si verifica un errore, il parametro returnCode indica il motivo dell'errore.

Esempio

cniCopyElementTree(&rc, inLastChild, outLastChild);
cniFinalize(&rc, outMessage);
cniWriteBuffer(&rc, outMessage);
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as07670_