IMGetReceiverMessageData

Autor: Alexander Berger
Headerdatei: ims.h

Prototyp
Retcode_t API_FUNCTION IMGetReceiverMessageData(
   IMReceiverMessage_s*      receiverMessage,
   IMMessageType_t           messageType,
   IMReceiverMessageData_s** receiverMessageData );

Kurzbeschreibung
Diese Funktion ermittelt aus einer
IMReceiverMessage_s-Struktur die Nachrichtendaten vom Typ 'messageType'. Es ist eine Hilfsfunktion für Weiterleitungsmodule, die diese Funktion verwenden, um nicht manuell den gerade benötigten Nachrichtentyp aus der IMReceiverMessage_s-Struktur zu suchen.

Parameter
receiverMessage - Ein Zeiger auf eine
IMReceiverMessage_s-Struktur. Diese Struktur wird dem Weiterleitungsmodul über die Funktion 'IMSMForwardMessage' übergeben.

messageType - Gibt den Nachrichtentyp an, der benötigt wird.

receiverMessageData - Zeiger auf einen IMReceiverMessageData_s-Zeiger. Nach dem erfolgreichen Aufruf zeigt dieser Zeiger auf die Daten vom Typ 'messageType'.

Rückgabewert:
Bei Erfolg RC_SUCCESS, ansonsten einer der in 'errdefs.h' definierten Fehlercodes.

Anmerkungen:
Keine