cniCreateMessage

Diese Funktion erstellt ein neues Ausgabenachrichtenobjekt. Bei jedem Aufruf dieser Funktion sollte ein entsprechender Aufruf von cniDeleteMessage stattfinden, damit zugeordnete Ressourcen zurückgegeben werden, wenn die Verarbeitung der Ausgabenachricht abgeschlossen wurde.

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). Rufen Sie mit cniGetMessageContext den Kontext aus einer eingehenden Nachricht ab (z. B. eine in der Funktion cniEvaluate empfangene Nachricht).

Rückgabewerte

Bei erfolgreicher Ausführung wird die Adresse des Nachrichtenobjekts zurückgegeben. Andernfalls wird der Wert null (CCI_NULL_ADDR) zurückgegeben, und der Parameter returnCode gibt die Fehlerursache an.

Beispiel

  outMsg = cniCreateMessage(&rc, cniGetMessageContext(&rc, message));
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
as07570_