IMDBGetFirstConnectionDataWithReceiver

Autor: Alexander Berger
Headerdatei: ims.h

Prototyp
Retcode_t API_FUNCTION IMDBGetFirstConnectionDataWithReceiver(
   UInt32_t            connectionId,
   Char_t*             appType,
   IMMessageId_t       messageId,
   String_t            platform,
   String_t            sourceAddress,
   PHEnum_t            iteratorHandle,
   IMConnectionData_s* connectionDataInfo );

Kurzbeschreibung
Diese Funktion startet eine Iteration über alle Verknüpfungen einer Verknüpfungsgruppe und einer bestimmten Quelle.

Parameter
connectionId - Identitikationsnummer der Verknüpfungsgruppe.

appType - Anwendungstyp der Quelle

messageId - Die Nachricht der Quelle

platform - Die Plattform, auf der die Quelle installiert ist.

sourceAddress - Die Adresse der Quelle

iteratorHandle - Zeiger auf einen HEnum_t-Typ. Diese Funktion füllt diesen Parameter mit Kontextinformationen, die der Aufrufer bei der Fortsetzung der Iteration mittels IMDBGetNextConnectionDataWithReceiver übergeben muß.

connectionDataInfo - Zeiger auf eine IMConnectionData_s-Struktur, welche bei Erfolg die Daten der ersten Verknüpfung erhält.

Rückgabewert:
Bei Erfolg RC_SUCCESS, ansonsten einer der in 'errdefs.h' definierten Fehlercodes.

Anmerkungen:
Keine