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