TSPI_lineAddToConference-Funktion (tspi.h)

Artikel
03/03/2024

Die funktion TSPI_lineAddToConference fügt den von hdConsultCall angegebenen Anruf der von hdConfCall angegebenen Telefonkonferenz hinzu.

Syntax

LONG TSPIAPI TSPI_lineAddToConference(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdConfCall,
  HDRVCALL      hdConsultCall
);

Parameter

dwRequestID

Der Bezeichner der asynchronen Anforderung.

hdConfCall

Das Handle für die Telefonkonferenz. Der Aufrufstatus von hdConfCall kann onHoldPendingConference oder onHold sein.

hdConsultCall

Das Handle für den Anruf, der der Telefonkonferenz hinzugefügt werden soll. Dieser Anruf kann weder ein übergeordnetes Element einer anderen Konferenz noch ein Teilnehmer an einer Konferenz sein. Abhängig von den in LINEADDRESSCAPS angegebenen Gerätefunktionen wurde der hdConsultCall-Parameter möglicherweise nicht unbedingt mithilfe von TSPI_lineSetupConference oder TSPI_linePrepareAddToConference eingerichtet. Der Aufrufstatus von hdConsultCall kann verbunden, onHold, proceeding oder ringback sein.

Rückgabewert

Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter der entsprechenden ASYNC_COMPLETION ist null, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_CONFERENCEFULL, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.

Hinweise

Der Dienstanbieter gibt LINEERR_INVALCALLHANDLE zurück, wenn hdConsultCall übergeordnetes Element einer anderen Konferenz oder bereits Teilnehmer an einer Konferenz ist oder hdConsultCall aus anderen Gründen nicht hinzugefügt werden kann, z. B. mit TSPI_lineSetupConference oder TSPI_linePrepareAddToConference.

Hinweis Das Anrufhandle der hinzugefügten Partei bleibt nach dem Hinzufügen des Anrufs zu einer Konferenz gültig. in der Regel ändert sich der Zustand in Konferenz, während der Zustand der Telefonkonferenz verbunden wird. Das Handle für einen einzelnen teilnehmenden Anruf kann später verwendet werden, um diese Partei mithilfe von TSPI_lineRemoveFromConference aus der Telefonkonferenz zu entfernen.

Die Anrufstatus der an einer Konferenz teilnehmenden Anrufe sind nicht unabhängig. Wenn Sie beispielsweise eine Telefonkonferenz ablegen, können alle teilnehmenden Anrufe automatisch in den Leerlauf geraten. TAPI kann die Gerätefunktionen der Leitung überprüfen, um zu bestimmen, welche Form der Konferenzentfernung verfügbar ist. TAPI oder die zugehörigen Clientanwendungen sollten die LINE_CALLSTATE Nachrichten nachverfolgen, um zu bestimmen, was mit den beteiligten Anrufen passiert ist.

Die Telefonkonferenz wird entweder über TSPI_lineSetupConference oder TSPI_lineCompleteTransfer eingerichtet. In der Regel wird der Einer Konferenz hinzugefügte Anruf mithilfe von TSPI_lineSetupConference oder TSPI_linePrepareAddToConference eingerichtet. Einige Schalter ermöglichen möglicherweise das Hinzufügen eines beliebigen Anrufs zur Konferenz, und ein solcher Anruf wurde möglicherweise mit TSPI_lineMakeCall eingerichtet und ist (hart) gehalten. Alle Anrufe, die Teil einer Konferenz sind, müssen in derselben offenen Leitung vorhanden sein.

Jede Überwachung (Medien, Töne, Ziffern) einer Telefonkonferenz gilt nur für den hdConfCall-Parameter , nicht für die einzelnen teilnehmenden Anrufe.

Diese Funktion hat keine Einschränkungen basierend auf Berechtigungen wie in der entsprechenden Funktion auf TAPI-Ebene. Es gibt keine explizite Anforderung für den Dienstanbieter, die Beziehungen zwischen der "übergeordneten" Telefonkonferenz und ihren Teilnehmern nachzuverfolgen, da keine TSPI-Korrespondenz mit der TAPI-Funktion vorhanden ist. Viele Dienstanbieter finden es möglicherweise erforderlich, diese Beziehungen intern nachzuverfolgen, um die anderen Funktionen für die Telefonkonferenzverwaltung zu implementieren.