Funzione linePrepareAddToConferenceW (tapi.h)

La funzione linePrepareAddToConference prepara una chiamata di conferenza esistente per l'aggiunta di un'altra parte.

Sintassi

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

Parametri

hConfCall

Gestire una conferenza telefonica. L'applicazione deve essere un proprietario di questa chiamata. Lo stato della chiamata di hConfCall deve essere connesso.

lphConsultCall

Puntatore a un handle HCALL. Questa posizione viene quindi caricata con un handle che identifica la chiamata di consultazione da aggiungere. Inizialmente, l'applicazione è l'unico proprietario di questa chiamata.

lpCallParams

Puntatore a un LINECALLPARAMS struttura contenente parametri di chiamata da utilizzare per stabilire la chiamata di consulenza. Questo parametro può essere impostato su NULL se non si desiderano parametri di configurazione delle chiamate speciali.

Valore restituito

Restituisce un identificatore di richiesta positivo se la funzione viene completata in modo asincrono o un numero di errore negativo se si verifica un errore. Il parametro dwParam2 del messaggio di LINE_REPLY corrispondente è zero se la funzione ha esito positivo o è un numero di errore negativo se si verifica un errore. I possibili valori restituiti sono:

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.

Osservazioni

Se viene restituito LINEERR_INVALLINESTATE, la riga non è attualmente in uno stato in cui è possibile eseguire questa operazione. Un elenco delle operazioni attualmente valide è disponibile nel membro dwLineFeatures (del tipo LINEFEATURE) nella struttura LINEDEVSTATUS. (La chiamata a lineGetLineDevStatus aggiorna le informazioni in LINEDEVSTATUS.)

È possibile ottenere un handle di conferenza telefonica con lineSetupConference o con lineCompleteTransfer risolto come conferenza telefonica a tre vie. La funzione linePrepareAddToConference inserisce in genere la chiamata di conferenza esistente nello stato onHoldPendingConfer ence e crea una chiamata di consultazione che può essere aggiunta successivamente alla conferenza telefonica esistente con lineAddToConference.

La chiamata di consultazione può essere annullata utilizzando lineDrop. Può anche essere possibile che un'applicazione si scambi tra la chiamata di consultazione e la conferenza telefonica tenuta con lineSwapHold.

Nota

L'intestazione tapi.h definisce linePrepareAddToConference come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	tapi.h
libreria	Tapi32.lib
dll	Tapi32.dll

Vedere anche

panoramica Conferenza

LINECALLPARAMS

LINEDEVSTATUS

LINE_REPLY

funzioni supplementari del servizio linea

lineAddToConference

lineCompleteTransfer

lineDrop

lineGetLineDevStatus

lineSetupConference

lineSwapHold