linePrepareAddToConference-Funktion (tapi.h)

Artikel
03/02/2024

Die Funktion linePrepareAddToConference bereitet eine vorhandene Telefonkonferenz für das Hinzufügen einer anderen Partei vor.

Syntax

LONG linePrepareAddToConference(
  HCALL                  hConfCall,
  LPHCALL                lphConsultCall,
  LPLINECALLPARAMS const lpCallParams
);

Parameter

hConfCall

Behandeln sie eine Telefonkonferenz. Die Anwendung muss besitzer dieses Aufrufs sein. Der Anrufstatus von hConfCall muss verbunden sein.

lphConsultCall

Zeiger auf ein HCALL-Handle. Dieser Standort wird dann mit einem Handle geladen, der den hinzuzufügenden Konsultationsaufruf identifiziert. Zunächst ist die Anwendung der alleinige Besitzer dieses Aufrufs.

lpCallParams

Zeiger auf eine LINECALLPARAMS-Struktur , die Aufrufparameter enthält, die beim Einrichten des Konsultationsaufrufs verwendet werden sollen. Dieser Parameter kann auf NULL festgelegt werden, wenn keine speziellen Aufrufsetupparameter gewünscht sind.

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 Meldung ist 0, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_BEARERMODEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_CALLUNAVAIL, LINEERR_INVALRATE, LINEERR_CONFERENCEFULL, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_NOTOWNER, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLPARAMS, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCONFCALLHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALLINESTATE, LINEERR_USERUSERINFOTOOBIG LINEERR_INVALMEDIAMODE, LINEERR_UNINITIALIZED.

Hinweise

Wenn LINEERR_INVALLINESTATE zurückgegeben wird, befindet sich die Zeile derzeit nicht in einem Zustand, in dem dieser Vorgang ausgeführt werden kann. Eine Liste der aktuell gültigen Vorgänge finden Sie im dwLineFeatures-Member (vom Typ LINEFEATURE) in der LINEDEVSTATUS-Struktur . (Durch Aufrufen von lineGetLineDevStatus werden die Informationen in LINEDEVSTATUS aktualisiert.)

Ein Telefonkonferenzhandle kann mit lineSetupConference oder mit lineCompleteTransfer abgerufen werden, das als Drei-Wege-Telefonkonferenz aufgelöst wird. Die Funktion linePrepareAddToConference versetzt die vorhandene Telefonkonferenz in der Regel in den Zustand onHoldPendingConference und erstellt einen Konsultationsaufruf, der später mit lineAddToConference der vorhandenen Telefonkonferenz hinzugefügt werden kann.

Der Beratungsaufruf kann per lineDrop abgesagt werden. Es kann auch möglich sein, dass ein Antrag zwischen der Konsultationsanruf und der gehaltenen Telefonkonferenz mit lineSwapHold ausgetauscht wird.