lineGetConfRelatedCalls-Funktion (tapi.h)

Artikel
08/26/2023

Die lineGetConfRelatedCalls-Funktion gibt eine Liste von Aufrufhandles zurück, die Teil derselben Telefonkonferenz wie der angegebene Anruf sind. Der angegebene Anruf ist entweder eine Telefonkonferenz oder ein Teilnehmeranruf in einer Telefonkonferenz. Für die Aufrufe, für die die Anwendung noch keine Handles aufweist, werden neue Handles generiert, und der Anwendung werden Überwachungsberechtigungen für diese Aufrufe gewährt.

Syntax

LONG lineGetConfRelatedCalls(
  HCALL          hCall,
  LPLINECALLLIST lpCallList
);

Parameter

hCall

Behandeln eines Anrufs. Dies ist entweder eine Telefonkonferenz oder ein Teilnehmeranruf in einer Telefonkonferenz. Bei einem übergeordneten Konferenzanruf kann der Anrufstatus von hCall ein beliebiger Zustand sein. Für eine Konferenzteilnehmeranrufe muss sie sich im Konferenzzustand befinden.

lpCallList

Zeiger auf eine datenvariable Größe vom Typ LINECALLLIST. Nach erfolgreichem Abschluss der Anforderung werden Anrufhandles für alle Anrufe in der Telefonkonferenz in dieser Struktur zurückgegeben. Der erste Anruf in der Liste ist die Telefonkonferenz, die anderen Anrufe sind die Teilnehmeranrufe. Der Anwendung wird die Berechtigung zur Überwachung der Aufrufe gewährt, für die sie noch nicht über Handles verfügt; Die Berechtigungen für Aufrufe in der Liste, für die die Anwendung bereits Über Handles verfügt, sind unverändert. Vor dem Aufrufen von lineGetConfRelatedCalls muss die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um die Menge an Arbeitsspeicher anzugeben, der TAPI zum Zurückgeben von Informationen zur Verfügung steht.

Hinweis Wenn die Größenparameter in der Struktur nicht korrekt sind, besteht die Möglichkeit, dass Daten überschrieben werden. Weitere Informationen zum Festlegen von Strukturgrößen finden Sie im Thema Speicherzuordnung .

Rückgabewert

Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOCONFERENCE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Hinweise

Der angegebene Anruf kann entweder ein Telefonkonferenzhandle oder ein Handle für einen Teilnehmeranruf sein. Beispielsweise ist ein Konsultationsaufruf, der noch nicht zu einer Telefonkonferenz hinzugefügt wurde, nicht Teil einer Konferenz. Der erste Eintrag in der Liste, der zurückgegeben wird, ist das Telefonkonferenzhandle, die anderen Handles sind alle Teilnehmeranrufe. Der angegebene Aufruf ist immer einer der in der Liste zurückgegebenen Aufrufe. Aufrufe in der Liste, für die die Anwendung nicht bereits über ein Anrufhandle verfügt, werden Monitorberechtigungen zugewiesen. Berechtigungen für Aufrufe, für die die Anwendung bereits Handles hat, bleiben unverändert. Die Anwendung kann lineSetCallPrivilege verwenden, um die Berechtigung des Aufrufs zu ändern.

Wenn lineGetConfRelatedCalls sofort aufgerufen wird, nachdem ein Anruf mithilfe von lineCompleteTransfer zu einer Konferenz hinzugefügt wurde, gibt lineGetConfRelatedCalls möglicherweise keine vollständige Liste verwandter Anrufe zurück, da TAPI auf den Empfang einer LINE_CALLSTATE-Nachricht wartet, die angibt, dass der Anruf LINECALLSTATE_CONFERENCED eingegeben wurde, bevor der Anruf tatsächlich Teil der Konferenz ist (d. h., der Konferenzstatus vom Dienstanbieter bestätigt wird). Nachdem die Anwendung die LINE_CALLSTATE-Nachricht erhalten hat, gibt lineGetConfRelatedCalls vollständige Informationen zurück.

Die Anwendung kann lineGetCallInfo und lineGetCallStatus für jeden Aufruf in der Liste aufrufen, um die Informationen des Aufrufs bzw. die status zu bestimmen.