cniGetMessageContext

Diese Funktion ruft die Adresse des Nachrichtenkontextes ab, der der angegebenen Nachricht zugeordnet ist. Mit dem Kontext einer vorhandenen Nachricht wird eine Ausgabenachricht erstellt, z. B. mit Hilfe der Funktion cniCreateMessage.

Syntax

CciMessageContext* cniGetMessageContext(
  int*         returnCode,
  CciMessage*  message);

Parameter

returnCode
Der Rückkehrcode aus der Funktion (Ausgabe). Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_INV_MESSAGE_OBJECT
message
Die Adresse des Nachrichtenobjekts (Eingabe).

Rückgabewerte

Bei erfolgreicher Ausführung wird die Adresse des Nachrichtenkontextes 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
as07600_