IMShowMessage

Autor: Alexander Berger
Headerdatei: ims.h

Prototyp
Retcode_t API_FUNCTION IMShowMessage(
   HWND                 parent,
   Char_t*              appType,
   Char_t*              sourceAddress,
   IMMessageId_t        messageId,
   IMMessageResponse_t* messageResponse );

Kurzbeschreibung
Diese Funktion vereinfacht die Darstellung einer Nachricht. Es wird intern IMShowMessageEx benutzt, um die Nachricht entsprechend weiterzuleiten. Es wird immer lokal eine Nachrichtenanzeige vorgenommen. Die Detailierung einer Nachricht wird auf die einfachste Stufe gesetzt und es sind keine Einfügedaten erlaubt.

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.

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.