lineAddToConference-Funktion (tapi.h)

Artikel
03/04/2024

Die lineAddToConference-Funktion fügt den von hConsultCall angegebenen Aufruf dem von hConfCall angegebenen Konferenzanruf hinzu.

Syntax

LONG lineAddToConference(
  HCALL hConfCall,
  HCALL hConsultCall
);

Parameter

hConfCall

Behandeln Sie die Konferenzanrufe. Die Anwendung muss besitzer dieses Aufrufs sein. Jegliche Überwachung (Medien, Töne, Ziffern) einer Telefonkonferenz gilt nur für den hConfCall, nicht für die einzelnen teilnehmenden Anrufe. Der Anrufstatus von hConfCall muss onHoldPendingConference oder onHold sein.

hConsultCall

Behandeln Sie den Anruf, der der Telefonkonferenz hinzugefügt werden soll. Die Anwendung muss besitzer dieses Aufrufs sein. Dieser Aufruf darf kein übergeordnetes Element einer anderen Konferenz oder Teilnehmer an einer Konferenz sein. Abhängig von den in LINEADDRESSCAPS angegebenen Gerätefunktionen wurde der hConsultCall möglicherweise nicht unbedingt mithilfe von lineSetupConference oder linePrepareAddToConference eingerichtet. Der Anrufstatus von hConsultCall muss verbunden, onHold, weiter oder ringback sein. Viele Nebenstellenanlagen ermöglichen es, Anrufe zu Konferenzen hinzuzufügen, bevor sie tatsächlich beantwortet werden.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden LINE_REPLY Nachricht ist 0, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_CONFERENCEFULL, LINEERR_NOTOWNER, LINEERR_INVALCONFCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Hinweise

Wenn LINEERR_INVALCALLHANDLE zurückgegeben wird, ist das angegebene Anrufhandle für den hinzugefügten Aufruf ungültig. hConsultCall ist ein übergeordnetes Mitglied einer anderen Konferenz oder bereits Teilnehmer an einer Konferenz; hConsultCall kann aus anderen Gründen nicht hinzugefügt werden (z. B. muss er mithilfe von lineSetupConference oder linePrepareAddToConference eingerichtet worden sein); oder hConsultCall und hConfCall sind Aufrufe auf verschiedenen offenen Zeilen.

Das Anrufhandle der hinzugefügten Partei bleibt nach dem Hinzufügen des Anrufs zu einer Konferenz gültig. Der Status ändert sich in der Regel in conferenced , während der Zustand der Telefonkonferenz in der Regel verbunden wird. Mithilfe von lineGetConfRelatedCalls können Sie eine Liste von Anrufhandles abrufen, 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. Das Handle für einen einzelnen teilnehmenden Anruf kann später verwendet werden, um diese Partei mithilfe von lineRemoveFromConference aus der Telefonkonferenz zu entfernen.

Wenn lineGetConfRelatedCalls unmittelbar nach lineAddToConference aufgerufen wird, wird möglicherweise keine vollständige Liste verwandter Anrufe zurückgegeben, da TAPI wartet, um eine LINE_CALLSTATE Nachricht zu erhalten, die angibt, dass der Anruf LINECALLSTATE_CONFERENCED eingegeben hat, bevor der Anruf tatsächlich Teil der Konferenz ist (d. h. der Konferenzstatus wird vom Dienstanbieter bestätigt). Nachdem die Anwendung die LINE_CALLSTATE-Nachricht erhalten hat, gibt lineGetConfRelatedCalls vollständige Informationen zurück.

Hinweis Alle Aufrufe, die Teil einer Konferenz sind, müssen in derselben offenen Zeile vorhanden sein.

Die Anrufzustände der an einer Konferenz teilnehmenden Aufrufe sind nicht unabhängig. Wenn Sie beispielsweise eine Telefonkonferenz ablegen, können alle teilnehmenden Anrufe automatisch im Leerlauf sein. Eine Anwendung sollte die Gerätefunktionen der Linie konsultieren, um zu bestimmen, welche Form des Entfernens von Konferenzen verfügbar ist. Die Anwendung sollte die LINE_CALLSTATE Nachrichten nachverfolgen, um zu bestimmen, was mit den betroffenen Anrufen passiert ist.

Die Telefonkonferenz wird entweder durch lineSetupConference oder lineCompleteTransfer eingerichtet. Der Einer Konferenz hinzugefügte Anruf wird in der Regel mithilfe von lineSetupConference oder linePrepareAddToConference eingerichtet. Einige Switches können das Hinzufügen beliebiger Anrufe zur Konferenz ermöglichen, und ein solcher Anruf kann mit lineMakeCall eingerichtet und (hart) gehalten werden. Die Anwendung kann den dwAddrCapFlags-Member der LINEADDRESSCAPS-Struktur untersuchen, um die zulässigen Vorgänge zu ermitteln.