IMDBGetNextMessage

Autor: Alexander Berger
Headerdatei: ims.h

Prototyp
Retcode_t API_FUNCTION IMDBGetNextMessage(
   HEnum_t      iteratorHandle,
   IMMessage_s* messageInfo );

Kurzbeschreibung
Diese Funktion setzt eine Iteration, die mit
IMDBGetFirstMessage gestartet worden ist, fort.

Parameter
iteratorHandle - Dieser Parameter wurde beim Start der Iteration über
IMDBGetFirstMessage generiert.

messageInfo - Zeiger auf eine IMMessage_s-Struktur, welche bei Erfolg die Daten der nächsten Nachricht erhält.

Rückgabewert:
Bei Erfolg RC_SUCCESS, ansonsten einer der in 'errdefs.h' definierten Fehlercodes. Die Iteration wurde ordnungsgemäß beendet, wenn der Code RC_NO_MORE_DATA zurückgegeben wird.

Anmerkungen:
Keine