IMSMForwardMessage

Autor: Alexander Berger
Headerdatei: imsm.h

Prototyp
Retcode_t MODULE_FUNCTION IMSMForwardMessage(
   String_t             receiverAddress,
   IMReceiverMessage_s* message,
   IMMessageResponse_t* response );

Kurzbeschreibung
Muß von einem Empfängermodul implementiert werden. Das IMS System übergibt dieser Funktion die Nachricht, die über einen bestimmten, modulspezifischen Kanal weitergeleitet werden muß. Das Modul ist dafür verantwortlich, daß die Nachricht übermittelt wird.

Parameter
receiverAddress - Ein String, der die Adresse des Empfängers enthält. Das ist eine modulspezifische Adresse, die das Modul über die IMSMGetFirst/NextReceiverAddress-Funktion angibt. Das Modul muß diese Adresse interpretieren und einen eindeutigen Empfänger bestimmen.

message - Zeiger auf eine IMReceiverMessage_s-Struktur. Diese Struktur enthält die Nachricht, die weitergeleitet werden soll. Der IMS Server versucht, die Daten komplett zur Verfügung zu stellen. Trotzdem sollte das Modul überprüfen, ob z.B. alle gewünschten Datenarten verfügbar sind.

response - Zeiger auf einen IMMessageResponse_t Datentyp. In dieser Variable erwartet der Aufrufer die Benutzerantwort. Als Antwort muß einer der MR_xxxx Konstanten zugewiesen werden. Falls das Modul keine synchrone Benutzerantwort unterstützt, muß MR_NOT_SUPPORTED gesetzt werden.

Rückgabewert:
Das Modul muß RC_SUCCESS zurückgeben, wenn es die Nachricht übermitteln konnte. Ansonsten einen der definierten Fehlercodes. Im Falle eines Fehlers wird vom IMS System versucht, diese Nachricht später noch einmal zu übermitteln.

Anmerkungen:
Keine