IMSMGetNextReceiverAddress

Autor: Alexander Berger
Headerdatei:
imsm.h

Prototyp
Retcode_t MODULE_FUNCTION IMSMGetNextReceiverAddress(
   HEnum_t              iterator,
   IMReceiverAddress_s* receiverAddress );

Kurzbeschreibung
Nachdem das IMS System eine Iteration über alle Kanäle, die das Modul zur Verfügung stellt, mit
IMSMGetFirstReceiverAddress gestartet hat, wird diese Funktion für jede weitere Adresse aufgerufen. Erst wenn das Modul einen Fehler meldet oder es keine Kanäle mehr gibt, wird die Iteration gestoppt.

Parameter
iterator - Variable vom Typ HEnum_t. Diese Variable enthält iterationsspezifische Daten des Moduls und wurde von diesem bei Aufruf der Funktion
IMSMGetFirstReceiverAddress gesetzt.

receiverAddress - Zeiger auf eine IMReceiverAddress_s - Struktur. Bei Erfolg muß diese Struktur die kompletten Daten zu einem Kanal (Empfänger) enthalten.

Rückgabewert:
Wenn ein Kanal eingetragen wurde, muß RC_SUCCESS zurückgegeben werden. Wenn keine Kanäle mehr verfügbar sind, muß das Modul RC_NO_MORE_DATA zurückgeben. Ansonsten wird einer der definierten Fehlercodes erwartet.

Anmerkungen:
Keine