cniGetMessageContext

Ruft die Adresse des Nachrichtenkontextes ab, der mit der angegebenen Nachricht verknüpft ist. Der Kontext einer vorhandenen Nachricht wird verwendet, um eine Ausgabenachricht zu erstellen (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 Erfolg wird die Adresse des Nachrichtenkontexts zurückgegeben. Ansonsten wird Null (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
as07600_