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.