IMShowMessageEx

Autor: Alexander Berger
Headerdatei: ims.h

Prototyp
Retcode_t API_FUNCTION IMShowMessageEx(
   HWND                 parent,
   Char_t*              appType,
   Char_t*              sourceAddress,
   IMMessageId_t        messageId,
   IMDetailLevel_t      detailLevel,
   UInt32_t             noOfInsertData,
   IMInsertData_s*      insertData,
   IMMessageResponse_t* messageResponse );

Kurzbeschreibung
Diese Funktion vereinfacht die Darstellung einer Nachricht. Es wird intern
IMProcessMessage benutzt, um die Nachricht entsprechend weiterzuleiten. Es wird immer lokal eine Nachrichtenanzeige vorgenommen.

Parameter
parent - Handle eines Fensters. Das lokale Nachrichtenfenster wird als Child-Fenster dieses Fensters geöffnet. Dieser Parameter ist optional und kann auch 0 gesetzt werden.

appType - Gibt den Anwendungstyp an, der diese Nachricht absetzt.

sourceAddress - Eine anwendungsspezifische Quellenadresse. Dieser Parameter ist optional und kann auch 0 gesetzt werden, wenn die Anwendung kein eigenes Quellenmodul verwendet.

messageId - Die Identifikationsnummer der Nachricht, die angezeigt werden soll.

detailLevel - Gibt den gewünschte Detailierungsgrad der Anzeige an. 0 entspricht der einfachsten Nachricht. Je höher die Nummer, desto detailierter die Nachricht.

noOfInsertData - Anzahl der Einfügedaten für diese Nachricht.

insertData - Zeiger auf ein Array vom Typ IMInsertData_s mit den Einfügedaten. Der IMS-Server wird diese Daten automatisch in die endgültige Nachricht einfügen.

messageResponse - Zeiger auf eine Variable, welche die Antwort bei synchroner Ausführung entgegennimmt. Die Antwort wird von einem Modul generiert, das einem Benutzer eine Auswahl erlaubt. Dieser Parameter ist optional und kann auch 0 gesetzt werden.

Rückgabewert:
Bei einer korrekten Verarbeitung RC_SUCCESS. Ansonsten einer der in 'errdefs.h' definierten Fehlercodes.

Anmerkungen:
Wenn die Funktion asynchron ausgeführt wird, bedeutet der Rückgabewert RC_SUCCESS lediglich, daß die Verarbeitung korrekt verlaufen ist. Die Nachricht muß noch nicht den Empfänger erreicht haben.