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, 2006 Letzte Aktualisierung: 18.05.2006
as07600_