cniCreateMessage

Erstellt ein neues Ausgabenachrichtobjekt. Für jeden Aufruf für diese Funktion sollte es einen entsprechenden Aufruf für cniDeleteMessage geben, um zugeordnete Ressourcen auszugeben, 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 mittels cniGetMessageContext den Kontext einer eingehenden Nachricht (z. B. eine, die mit der Funktion cniEvaluate empfangen wurde) ab.

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 | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as07570_