cniCreateMessage

Crea un nuovo oggetto messaggio di output. Per ogni chiamata a questa funzione, deve essere presente una chiamata corrispondente su cniDeleteMessage per restituire le risorse assegnate una volta terminata l'elaborazione sul messaggio di output.

Sintassi

CciMessage* cniCreateMessage(
  int*      returnCode,
  CciMessageContext*  messageContext);

Parametri

returnCode
Il codice di ritorno dalla funzione (output).
I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_FAILURE
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_CONTEXT
messageContext
L'indirizzo del contesto per il messaggio (input). Utilizzare cniGetMessageContext per ottenere il contesto da un messaggio in entrata (ad esempio, uno ricevuto nella funzione cniEvaluate).

Valori di restituzione

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

Esempio

  outMsg = cniCreateMessage(&rc, cniGetMessageContext(&rc, message));
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as07570_