cniCreateMessage

Mit dieser Funktion können Sie ein Ausgabenachrichtenobjekt erstellen. Für jeden Aufruf dieser Funktion müssen Sie einen entsprechenden Aufruf der Funktion cniDeleteMessage einfügen, damit die zugeordneten Ressourcen nach der Verarbeitung der Ausgabenachricht zurückgegeben werden.

Syntax

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

Parameter

returnCode
Der Rückkehrcode aus der Funktion (Ausgabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_FAILURE
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_CONTEXT
messageContext
Die Adresse des Kontextes für die Nachricht (Eingabe). Mit cniGetMessageContext rufen Sie den Kontext einer eingehenden Nachricht ab, zum Beispiel einer Nachricht, die über die Funktion cniEvaluate empfangen wurde.

Rückgabewerte

Bei Erfolg wird die Adresse des Nachrichtenobjekts zurückgegeben. Ansonsten wird ein Nullwert (CCI_NULL_ADDR) ausgegeben und der Parameter returnCode gibt den Grund für den Fehler an.

Beispiel

  outMsg = cniCreateMessage(&rc, cniGetMessageContext(&rc, message));
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2013-02-27 15:22:23


ReferenzthemaReferenzthema | Version 8.0.0.2 | as07570_